Bantuan PlugBench
PlugBench adalah server web lokal untuk Mac Anda, yang dibuat untuk membangun dan menguji plugin dan tema. Halaman ini mencakup semua yang dapat dilakukannya.
Memulai
- Buka
PlugBench.dmgdan seret PlugBench ke dalam Applications. - Buka PlugBench. Saat pertama kali dijalankan, jendela selamat datang akan menampilkan daftar kebutuhannya: nginx, PHP, MariaDB, dan Mailpit, semuanya dari Homebrew.
- Klik Siapkan PlugBench. Terminal akan terbuka dan menginstal semuanya, termasuk Homebrew jika belum terpasang. Homebrew mungkin akan meminta kata sandi Mac Anda sekali. PlugBench akan memberi tahu Anda ketika pengaturan selesai.
- Klik Mulai, lalu Situs Baru.
Persyaratan: macOS 14 atau lebih baru, Apple Silicon atau Intel, sekitar 2 GB ruang kosong untuk server.
Menutup jendela akan membuat situs tetap berjalan. PlugBench tetap berada di bilah menu. Keluar dari PlugBench untuk menghentikan semuanya.
Jendela
- Situs, di sebelah kiri: setiap situs, beserta CMS dan alamatnya. Pilih salah satu untuk melihat detailnya.
- Layanan: hanya yang sedang berjalan saat ini, seperti nginx, PHP 8.5, MariaDB, Mailpit, dan Redis.
- Tombol bilah alat: phpMyAdmin, Adminer, Mail, Sites (membuka folder situs), Logs, dan Versions.
- Bilah berbagi: muncul saat situs dibagikan, dengan tombol untuk menyalin tautan atau menghentikan berbagi.
- Ikon bilah menu: mulai atau berhenti, buka situs apa pun setelah masuk, hentikan berbagi, buka email.
Setiap halaman situs memiliki kartu-kartu ini:
- Judul
- Nama, alamat, dan baris seperti WordPress · PHP 8.5 · MariaDB 13.0. Tombol Buka Situs dan Buka Admin.
- PHP dan Server
- Versi PHP, memori, ukuran unggahan, batas waktu, Xdebug, server basis data, HTTPS, dan Terminal.
- iPhone
- Buka di iPhone Simulator, atau pindai kode QR dengan iPhone sungguhan.
- Bagikan secara daring
- Tautan https publik sementara.
- Perkembangan
- Plugin yang terhubung, mode debug, log, dan pembaruan.
- Cadangan
- Cadangkan, pulihkan, dan klon.
- Basis data
- Nama, pengguna, kata sandi, port, dan tombol untuk membukanya di phpMyAdmin.
Membuat situs web
Klik Situs Baru, pilih apa yang ingin diinstal, beri nama, lalu klik Buat Situs.
| Pilihan | Apa yang Anda dapatkan |
|---|---|
| WordPress | WordPress versi terbaru. Contoh konten: tidak ada, blog dengan foto, toko WooCommerce dengan 17 produk, kategori, pelanggan, dan pesanan, atau data uji. |
| Joomla | Joomla versi terbaru, siap untuk masuk. |
| Drupal | Drupal dengan Drush. Contoh majalah opsional dengan artikel dan foto. |
| Gravitasi | CMS berbasis file datar, tanpa basis data. |
| Craft CMS, TYPO3, Statamic, Laravel, Symfony | Diinstal dari resep menggunakan Composer. |
| Kode Pos Kustom | Situs PHP apa pun dari file ZIP, dengan file SQL opsional untuk diimpor. Gunakan ini untuk menyalin situs klien secara lokal. |
| Kosong | Sebuah folder kosong berisi PHP dan basis data, untuk kode Anda sendiri. |
Opsi di jendela Situs Baru: Versi PHP, basis data , rilis CMS tertentu, dan jaringan WordPress untuk Multisite.
Setiap situs mendapatkan alamatnya sendiri, seperti http://my-site.localhost:8801, basis datanya sendiri, dan administratornya sendiri. Situs hanya dapat diakses dari Mac Anda kecuali Anda membagikannya.
Masuk dengan sekali klik
Open Admin dan Open Site akan membuat Anda masuk sebagai administrator. Tidak perlu mengetik kata sandi. Ini berfungsi di WordPress, Joomla, Drupal, Craft, dan Statamic.
Setiap klik akan membuat tautan masuk sekali pakai yang berlaku selama 2 menit. Nama dan kata sandi administrator juga akan ditampilkan di halaman situs jika Anda membutuhkannya.
Menguji sebuah plugin
- Di bagian Pengembangan, klik Tautkan Folder Plugin… dan pilih folder tempat Anda melakukan pengkodean.
- PlugBench menghubungkannya ke situs dan mengaktifkannya. Tidak ada yang disalin: setiap penyimpanan akan ditampilkan pada pemuatan halaman berikutnya.
- Aktifkan mode Debug untuk menulis pemberitahuan dan peringatan PHP ke log debug, lalu klik Lihat Log untuk membacanya.
- Menghapus tautan akan memutusnya dari situs. Folder Anda tidak akan pernah disentuh.
Untuk menguji plugin pada beberapa versi PHP, klon situs ke versi lain (lihat Cadangan) atau ubah versi PHP situs.
PHP per situs
Setiap situs memiliki versi PHP-nya sendiri. Ubah di PHP dan Server pada halaman situs. Situs akan memulai ulang dengan versi baru dalam hitungan detik.
Tersedia: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 dan 8.5. Instal lebih banyak di Versi. PHP 7.4 dan 8.0 sudah tidak didukung lagi dan berasal dari shivammathur/php .
Pengaturan per situs, agar sesuai dengan host klien:
- Memori:
memory_limit, misalnya 128M atau 512M. - Ukuran unggahan:
upload_max_filesizedanpost_max_size. - Batas waktu:
max_execution_time, dalam detik.
Setiap pengaturan hanya berlaku untuk situsnya masing-masing.
Ekstensi Xdebug dan PHP
Di bagian Versi, setiap PHP yang terinstal menampilkan ekstensi yang dimilikinya. Klik salah satu untuk membangunnya untuk versi PHP tersebut (sekitar satu menit):
- Xdebug: debugging langkah demi langkah.
- Redis: phpredis, untuk plugin cache objek.
- Imagick: Pengeditan gambar ImageMagick.
- Memcached: untuk cache objek Memcached.
Kemudian aktifkan Xdebug pada situs. Xdebug tetap nonaktif untuk setiap versi PHP yang tidak memerlukannya di situs mana pun, jadi tidak dikenakan biaya.
VS Code: instal ekstensi PHP Debug, klik Salin Pengaturan VS Code, tempelkan ke .vscode/launch.json, dan mulai Listen for Xdebug. PlugBench menggunakan port 9003. PhpStorm mendengarkan pada port 9003 secara default dan bekerja dengan cara yang sama.
Basis data
Server default adalah MariaDB, pada port 3307 sehingga tidak pernah bertemu dengan MySQL yang sudah Anda jalankan pada port 3306. Instal lebih banyak server di Versi:
- MariaDB 10.6, 10.11, 11.4, 11.8
- MySQL 8.0, 8.4, 9.7
Setiap server berjalan pada portnya masing-masing. Pilih salah satu saat Anda membuat situs, atau pindahkan situs yang sudah ada melalui Server Basis Data : PlugBench akan membuang basis data, mengimpornya ke server lain, dan memperbarui konfigurasi situs.
phpMyAdmin dan Adminer terbuka dalam keadaan sudah masuk, dengan semua server terdaftar. Kartu Database pada sebuah situs akan langsung membuka database situs tersebut. Kedua alat ini hanya berfungsi di Mac Anda.
PostgreSQL 17 tersedia sebagai layanan, pada port 5433, pengguna postgres, dengan kata sandi yang sama dengan pengguna root MySQL.
HTTPS lokal
- Di bagian Versi, instal mkcert.
- Klik Percayai HTTPS Lokal… sekali. Terminal akan meminta kata sandi Mac Anda untuk menambahkan otoritas sertifikat lokal.
- Aktifkan HTTPS pada sebuah situs. Situs tersebut akan diakses melalui port +1000, misalnya
https://my-site.localhost:9801.
Di WordPress, PlugBench memperbarui alamat situs di basis data, termasuk Multisite. Mematikan HTTPS akan mengembalikan alamat tersebut ke versi sebelumnya.
WordPress Multisite
Aktifkan jaringan WordPress di Situs Baru. Anda akan mendapatkan jaringan dengan situs-situs di subdirektori, seperti /shop/. Tambahkan situs di Situs Saya, Admin Jaringan, Situs. Kloning, HTTPS, dan berbagi menjaga agar jaringan tetap berfungsi.
Terminal dan WP-CLI
Membuka Terminal di sebuah situs akan membuka shell di folder situs tersebut, dengan PHP situs tersebut berada di path pertama dan wp siap digunakan. php, composer , dan wp semuanya menggunakan versi PHP situs tersebut. Pengaturan shell Anda sendiri juga akan dimuat.
wp plugin list wp user create editor editor@example.com --role=editor wp eval 'echo get_option("home");'
Email, log, dan debug
- Email akan membuka Mailpit. Setiap email yang dikirim situs web akan masuk ke sana: pengaturan ulang kata sandi, pesanan WooCommerce, formulir kontak. Tidak ada yang keluar dari Mac Anda.
- Mode debug mengaktifkan
WP_DEBUGdanWP_DEBUG_LOGdi WordPress. - Logs menampilkan log debug, log kesalahan PHP, dan kesalahan nginx. Clear mengosongkannya sebelum pengujian.
Cadangan, kloning, dan pembaruan
- Cadangkan Sekarang menyimpan file dan basis data. Pulihkan mengembalikan cadangan terbaru.
- Perintah clone menyalin situs web dengan nama baru, dan secara opsional menggunakan versi PHP yang berbeda. Alamat-alamat di dalam basis data juga diperbarui.
- Update melakukan pencadangan basis data, lalu memperbarui CMS. Pada WordPress, Update Plugins and Themes memperbarui sisanya.
- Menghapus akan menghapus situs, basis data, dan sertifikatnya.
Layanan
Instal dari Versi. Setelah terinstal, program akan berjalan dan berhenti bersamaan dengan PlugBench.
| Melayani | Menggunakan | Alamat |
|---|---|---|
| Redis | Plugin cache objek | 127.0.0.1:6379 |
| Memcached | Cache objek | 127.0.0.1:11211 |
| PostgreSQL 17 | Laravel, Drupal | 127.0.0.1:5433 |
| Node.js | Pengembangan blok, alat bantu pembuatan | di jalur Terminal |
| mkcert | HTTPS lokal | |
| Mailpit | Menerima email | localhost:8025 |
| awan menyala | Bagikan secara daring |
iPhone
- "Open in Simulator" membuka situs di iPhone Simulator, dalam keadaan sudah masuk. Ini membutuhkan Simulator dari Xcode.
- iPhone asli: klik Bagikan di Wi-Fi, lalu pindai kode QR dengan kamera iPhone. iPhone harus terhubung ke Wi-Fi yang sama. Matikan fitur berbagi setelah selesai.
Alat AI (MCP)
PlugBench menggunakan Model Context Protocol, sehingga Claude Code, Claude Desktop, Cursor, dan alat AI lainnya dapat mengoperasikannya. Hubungkan Claude Code dengan satu perintah:
claude mcp add plugbench -- "/Applications/PlugBench.app/Contents/MacOS/plugbench" mcp
Kemudian, misalnya, tanyakan: Buat toko WooCommerce, tautkan ~/Code/my-plugin, aktifkan mode debug, lakukan pemesanan, dan beri tahu saya jika ada peringatan PHP yang muncul.
Ke-26 alat tersebut:
run_php menjalankan kode di dalam WordPress, dengan masuk sebagai administrator. iphone_screenshot memungkinkan AI untuk melihat situs di iPhone.
Baris perintah
Semua fitur di aplikasi ini juga berfungsi dari Terminal. Tambahkan alat ini ke path Anda:
ln -s /Applications/PlugBench.app/Contents/MacOS/plugbench /opt/homebrew/bin/plugbench
| Layanan | |
|---|---|
plugbench mulai | berhenti | status | Layanan kontrol |
dokter meja colokan | Tampilkan alat yang terdeteksi |
versi plugbench | Daftar PHP, server basis data, dan layanan |
plugbench tambah<formula> | Instal salah satunya, seperti php@7.4 atau mysql@8.0 |
ekstensi meja kerja<php><name> | Bangun xdebug, redis, imagick atau memcached |
| Situs | |
daftar plugbench | Daftar situs |
instalasi plugbench<cms><name> [sumber] | Buat situs. Opsi: --sample, --version, --sql, --database, --php, --multisite |
informasi plugbench<slug> | Detail dan informasi login dalam format JSON |
login plugbench<slug> [admin|depan] | Cetak tautan masuk sekali pakai |
hapus plugbench<slug> | Hapus situs |
plugbench ganti nama alamat<slug> | Pindahkan situs lama ke slug.localhost |
| PHP dan server | |
plugbench php<slug><version> | Ubah versi PHP |
pengaturan plugbench php<slug><name><value> | batas_memori, ukuran_file_unggah_maksimum, waktu_eksekusi_maksimum |
plugbench xdebug<slug> hidup|mati | Xdebug pada port 9003 |
plugbench move-db<slug><formula> | Pindahkan basis data, atau default |
plugbench https<slug> hidup|mati | HTTPS lokal |
terminal meja colokan<slug> | Terminal dengan PHP dan WP-CLI situs tersebut |
| Plugin dan debugging | |
tautan plugbench<slug><folder> | Hubungkan dan aktifkan plugin |
plugbench unlink<slug><folder> | Hapus plugin yang terhubung |
plugin plugbench<slug> | Daftar plugin sebagai JSON |
debug plugbench<slug> hidup|mati | Pencatatan WP_DEBUG |
log bangku colokan<slug> [baris] | Tampilkan log |
plugbench logs-clear<slug> | Log kosong |
jalankan plugbench<slug><file.php|-> | Menjalankan PHP di dalam sebuah situs web |
surat plugbench | Daftar email yang tertangkap |
| Cadangan dan pembaruan | |
pencadangan | pemulihan plugbench<slug> | Cadangkan atau pulihkan |
klon plugbench<slug><name> [php] | Salin situs web |
versi plugbench<slug> | CMS sudah terpasang dan versi terbaru |
pembaruan plugbench<slug> | Perbarui CMS |
plugbench update-extensions<slug> | Perbarui plugin dan tema |
| Alat dan berbagi | |
plugbench phpmyadmin [slug] | Alamat phpMyAdmin |
administrator plugbench | Alamat Adminer |
plugbench share on|off | Berbagi Wi-Fi |
plugbench share-online<slug> [email|berhenti] | Tautan publik |
plugbench iphone<slug> [jalur] | Simulator dan tangkapan layar |
resep plugbench | Daftar resep |
lisensi plugbench [aktifkan]<key> | nonaktifkan] | Lisensi |
plugbench mcp | Jalankan server MCP |
Resep: tambahkan CMS Anda sendiri
Resep adalah file JSON kecil yang memberi tahu PlugBench cara menginstal CMS atau framework. Letakkan resep Anda di ~/Library/Application Support/PlugBench/recipes/ dan resep tersebut akan muncul di menu Situs Baru.
{ "id": "winter", "title": "CMS Musim Dingin", "summary": "CMS berbasis Laravel.", "minimumPHP": "8.1", "composer": "wintercms/winter", "docroot": "", "adminPath": "/backend", "env": { "file": ".env", "copyFrom": ".env.example", "values": { "APP_URL": "{url}", "DB_HOST": "{db_host}", "DB_PORT": "{db_port}", "DB_DATABASE": "{db_name}", "DB_USERNAME": "{db_user}", "DB_PASSWORD": "{db_password}" } }, "steps": [ ["php", "artisan", "winter:up"] ] }
Kolom utama: composer atau zip untuk sumber, docroot untuk folder yang disajikan, database: false untuk CMS berbasis flat-file, loginWithEmail dan loginCommand untuk masuk sekali klik. Placeholder: {url}, {root}, {db_host}, {db_port}, {db_name}, {db_user}, {db_password}, {admin_user}, {admin_password}, {admin_email}.
Anda juga dapat mengklik Tambah Resep… di Situs Baru. Hanya tambahkan resep yang Anda percayai: langkah-langkahnya dijalankan sebagai pengguna Anda.
resep PlugBench mencantumkan resep-resep yang dilihat oleh PlugBench.
Gratis dan Pro
| Bebas | Pro, $29 sekali bayar | |
|---|---|---|
| Situs | 3 | Tak terbatas |
| Semua versi CMS, PHP dan basis data, Xdebug, HTTPS, cadangan, phpMyAdmin, Mailpit | Ya | Ya |
| Berbagi secara daring dan melalui Wi-Fi | Ya | |
| Alat iPhone | Ya | |
| Alat AI (MCP) | Ya |
Aktifkan kunci di Lisensi pada halaman utama, atau dengan perintah plugbench license activate KEY. Kunci tersebut berfungsi di Mac Anda; nonaktifkan satu kunci untuk memindahkannya. PlugBench memeriksa kunci seminggu sekali dan tetap berfungsi selama 30 hari secara offline.
Di mana letak berbagai hal
| Situs | ~/PlugBench/<slug> |
| Pengaturan, log, basis data, cadangan | ~/Pustaka/Dukungan Aplikasi/PlugBench |
| Resep Anda | …/PlugBench/resep |
| Cadangan | …/PlugBench/backups |
| Log | …/PlugBench/logs |
| Server | Homebrew, /opt/homebrew |
Pelabuhan
| Situs | 8801 ke atas; HTTPS pada port yang sama + 1000 |
| phpMyAdmin | 8799 |
| Adminer | 8800 |
| Mailpit | 8025 (web), 1025 (SMTP) |
| MariaDB, default | 3307 |
| Server basis data lainnya | 3308 dan seterusnya |
| Redis, Memcached, PostgreSQL | 6379, 11211, 5433 |
| Xdebug | 9003 (editor Anda mendengarkan) |
Semua perangkat hanya mendengarkan pada frekuensi 127.0.0.1 , kecuali situs-situs yang mengaktifkan berbagi Wi-Fi.
Penyelesaian Masalah
Proses memulai gagal atau layanan tetap mati
Buka Log dan baca kesalahannya. Sebuah port mungkin sudah digunakan oleh server lain, seperti MAMP atau Valet: tutup server tersebut dan klik Mulai lagi. `plugbench doctor` akan menampilkan apa yang ditemukan oleh PlugBench.
Pengaturan dihentikan di Terminal
Baca baris terakhir di Terminal. Seringkali Homebrew meminta kata sandi Anda atau alat baris perintah Xcode. Jawab, lalu klik Set Up PlugBench lagi: proses akan berlanjut dari tempat terakhir berhenti.
Open Admin menampilkan halaman masuk
Tautan masuk berlaku selama 2 menit dan hanya dapat digunakan sekali. Klik Buka Admin lagi. Jika masih gagal, kata sandi admin ada di halaman situs.
Browser memberikan peringatan tentang HTTPS
Klik "Percayai HTTPS Lokal…" di bagian Versi sekali, lalu mulai ulang browser. Firefox membutuhkan nss dari Homebrew agar dapat mempercayainya.
Ekstensi tidak dibangun
Ekstensi hanya dapat ditambahkan ke PHP melalui Homebrew. Baca output Terminal di Log; menginstal alat baris perintah Xcode terbaru dengan xcode-select --install seringkali memperbaikinya.
Xdebug tidak berhenti di titik henti (breakpoint)
Pastikan Xdebug diaktifkan untuk situs tersebut, editor Anda mendengarkan pada port 9003, dan permintaan browser berasal dari situs yang sama. Perintah di Terminal dijalankan dengan Xdebug dimatikan.
iPhone tidak dapat membuka situs tersebut
Aktifkan berbagi Wi-Fi, pastikan keduanya terhubung ke Wi-Fi yang sama, dan izinkan koneksi masuk jika macOS meminta. Jaringan tamu sering kali memblokir perangkat agar tidak dapat saling mendeteksi.
Tautan bersama tersebut berhenti berfungsi
Tautan Cloudflare Quick Tunnel bersifat sementara dan akan berakhir saat berbagi berhenti atau Mac dalam mode tidur. Bagikan lagi untuk mendapatkan tautan baru.
Bagaimana cara menghapus PlugBench sepenuhnya?
Tutup PlugBench, hapus dari Aplikasi, dan hapus ~/Library/Application Support/PlugBench dan ~/PlugBench. Paket Homebrew tetap ada; hapus dengan brew uninstall jika Anda mau.
Pertanyaan: support@nextstarsystems.com.