Lewati ke konten
NextPDF

Menginstal NextPDF Connect

Sekilas

Bagian berjudul “Sekilas”

Instal nextpdf/server dengan Composer, lalu jalankan salah satu dari tiga titik masuk transport. Pemasangan inti hanya memerlukan PHP 8.4 dan mesin NextPDF. Redis dan Premium bersifat opsional.

Pemasangan

Bagian berjudul “Pemasangan”
Terminal window
composer require nextpdf/server

Perintah ini memasang nextpdf/core: ^3.0. Paket ini mendeklarasikan php: >=8.4 <9.0, sehingga Composer akan menolak pemasangan pada PHP 8.3 atau versi yang lebih lama, atau pada PHP 9.

Tinjauan konseptual

Bagian berjudul “Tinjauan konseptual”

Paket ini adalah paket Composer bertipe library. Setelah dipasang, paket ini menambahkan empat titik masuk konsol ke vendor/bin/:

  • vendor/bin/nextpdf-mcp — server stdio Model Context Protocol (MCP).
  • vendor/bin/nextpdf-server — server Representational State Transfer (REST) (worker HTTP RoadRunner).
  • vendor/bin/nextpdf-grpc — server gRPC (worker gRPC RoadRunner).
  • vendor/bin/generate-skills — mengekspor katalog tool sebagai skill agen.

Skrip kelima, bin/nextpdf-prune, disertakan dalam repositori untuk tugas pemeliharaan. Jalankan skrip tersebut secara langsung, bukan melalui vendor/bin/.

Anda tidak memerlukan service provider, bundle, atau pendaftaran framework. Server berjalan sebagai proses mandiri. Ini bukan library untuk diintegrasikan ke dalam aplikasi host.

Permukaan API

Bagian berjudul “Permukaan API”

Composer juga memasang dependensi runtime paket ini. Dependensi transitifnya mencakup tumpukan Hypertext Transfer Protocol (HTTP) dan gRPC:

  • league/route dan nyholm/psr7 — perutean REST dan pesan PHP Standard Recommendation (PSR)-7.
  • spiral/roadrunner-http dan spiral/roadrunner-grpc — runtime worker RoadRunner untuk transport REST dan gRPC.
  • psr/http-server-middleware dan psr/http-server-handler — kontrak middleware PSR-15 yang diimplementasikan oleh pipeline REST.
  • symfony/yaml — penguraian berkas konfigurasi.
  • ramsey/uuid — pengenal permintaan dan sumber daya.

Jangan pasang paket-paket ini secara langsung. Composer menyelesaikan resolusi paket-paket tersebut untuk Anda dari nextpdf/server.

Contoh kode — Mulai cepat

Bagian berjudul “Contoh kode — Mulai cepat”

Untuk memeriksa pemasangan, tampilkan katalog tool tanpa menjalankan server:

Terminal window
./vendor/bin/generate-skills --dry-run --list-tools

Perintah ini menjalankan registry, melakukan deteksi tier, dan mencetak tool yang diekspos oleh pemasangan ini. Daftar tersebut mencerminkan paket opsional yang terpasang. Lihat /connect/tool-catalog/.

Contoh kode — Produksi

Bagian berjudul “Contoh kode — Produksi”

Pemasangan produksi menyematkan dependensi dan melewati perkakas pengembangan:

Terminal window
composer require nextpdf/server --no-dev
composer install --no-dev --optimize-autoloader --classmap-authoritative

Untuk transport REST dan gRPC, pasang juga biner RoadRunner. RoadRunner adalah supervisor proses yang mengelola worker pool. Paket PHP menyediakan worker, bukan supervisor:

Terminal window
./vendor/bin/rr get-binary

Kasus tepi dan hal yang perlu diperhatikan

Bagian berjudul “Kasus tepi dan hal yang perlu diperhatikan”

  • Redis opsional. Ekstensi ext-redis bersifat suggest, bukan require. Tanpanya, server REST menggunakan penyimpanan rate-limit, idempotensi, dan dokumen di dalam memori. Penyimpanan di dalam memori tersebut sesuai untuk satu worker, tetapi tidak dibagikan di antara pool dengan banyak worker. Untuk deployment dengan banyak worker, pasang ext-redis dan atur variabel lingkungan Redis. Lihat /connect/configuration/.

  • Premium opsional. nextpdf/premium bersifat suggest. Saat Anda memasangnya bersama server, probe deteksi tier di registry menemukan kelas provider-nya dan mendaftarkan tool Pro dan Enterprise tambahan. Tanpanya, hanya katalog inti yang disajikan. Ini adalah keputusan pengemasan yang dibuat pada saat composer require, bukan tombol runtime.

  • Server MCP tidak memerlukan RoadRunner. nextpdf-mcp adalah proses PHP biasa yang berkomunikasi melalui JavaScript Object Notation Remote Procedure Call (JSON-RPC) di atas standard input dan output (stdio). RoadRunner hanya diperlukan untuk transport REST dan gRPC.

Kinerja

Bagian berjudul “Kinerja”

Resolusi dependensi Composer menyumbang sebagian besar biaya saat pemasangan. Pada image produksi, gunakan --prefer-dist dan classmap otoritatif agar waktu autoload cold-boot tetap rendah. Biaya boot server itu sendiri berasal dari pemindaian registry dan deteksi tier. performance_budget pada halaman ini membatasi biaya boot tersebut.

Catatan keamanan

Bagian berjudul “Catatan keamanan”

Pasang hanya dari paket Packagist resmi nextpdf/server. Sematkan versi di composer.json dan commit composer.lock agar katalog tool yang di-deploy dapat direproduksi. Transport berjaringan memerlukan kunci application programming interface (API) sebelum melayani endpoint apa pun selain health; lihat /connect/security-and-operations/.

Kesesuaian

Bagian berjudul “Kesesuaian”

Halaman ini hanya menjelaskan mekanisme pemasangan. Kutipan kesesuaian protokol dan keamanan disematkan di /transports/mcp/, /transports/rest/, /transports/grpc/, dan /connect/security-and-operations/.

Konteks komersial

Bagian berjudul “Konteks komersial”

Pemasangan inti berfungsi sepenuhnya. Pemasangan ini menangani pembuatan dokumen, inspeksi, dan diagnostik melalui ketiga transport. Menambahkan nextpdf/premium memperluas katalog tanpa mengubah model transport atau autentikasi.

Lihat juga

Bagian berjudul “Lihat juga”
  • /connect/overview/ — apa yang disediakan paket
  • /connect/quickstart/ — pertukaran pertama yang dapat dijalankan
  • /connect/configuration/ — variabel lingkungan dan berkas konfigurasi
  • /connect/deployment/ — RoadRunner, Docker, dan deployment transport gabungan
  • /connect/tool-catalog/ — tool yang diekspos oleh pemasangan ini