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

  1. Buka PlugBench.dmg dan seret PlugBench ke dalam Applications.
  2. Buka PlugBench. Saat pertama kali dijalankan, jendela selamat datang akan menampilkan daftar kebutuhannya: nginx, PHP, MariaDB, dan Mailpit, semuanya dari Homebrew.
  3. 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.
  4. 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.

PilihanApa yang Anda dapatkan
WordPressWordPress versi terbaru. Contoh konten: tidak ada, blog dengan foto, toko WooCommerce dengan 17 produk, kategori, pelanggan, dan pesanan, atau data uji.
JoomlaJoomla versi terbaru, siap untuk masuk.
DrupalDrupal dengan Drush. Contoh majalah opsional dengan artikel dan foto.
GravitasiCMS berbasis file datar, tanpa basis data.
Craft CMS, TYPO3, Statamic, Laravel, SymfonyDiinstal dari resep menggunakan Composer.
Kode Pos KustomSitus PHP apa pun dari file ZIP, dengan file SQL opsional untuk diimpor. Gunakan ini untuk menyalin situs klien secara lokal.
KosongSebuah 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

  1. Di bagian Pengembangan, klik Tautkan Folder Plugin… dan pilih folder tempat Anda melakukan pengkodean.
  2. PlugBench menghubungkannya ke situs dan mengaktifkannya. Tidak ada yang disalin: setiap penyimpanan akan ditampilkan pada pemuatan halaman berikutnya.
  3. Aktifkan mode Debug untuk menulis pemberitahuan dan peringatan PHP ke log debug, lalu klik Lihat Log untuk membacanya.
  4. 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_filesize dan post_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

  1. Di bagian Versi, instal mkcert.
  2. Klik Percayai HTTPS Lokal… sekali. Terminal akan meminta kata sandi Mac Anda untuk menambahkan otoritas sertifikat lokal.
  3. 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_DEBUG dan WP_DEBUG_LOG di 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.

MelayaniMenggunakanAlamat
RedisPlugin cache objek127.0.0.1:6379
MemcachedCache objek127.0.0.1:11211
PostgreSQL 17Laravel, Drupal127.0.0.1:5433
Node.jsPengembangan blok, alat bantu pembuatandi jalur Terminal
mkcertHTTPS lokal
MailpitMenerima emaillocalhost:8025
awan menyalaBagikan 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.

Berbagi situs

Share Online memberikan tautan sementara https://…trycloudflare.com melalui terowongan Cloudflare gratis. Tidak perlu akun. Kirimkan ke klien untuk meninjau situs yang berjalan di Mac Anda.

  • Untuk membatasi siapa yang dapat membukanya, masukkan alamat email atau *@client.com. Cloudflare meminta pengunjung untuk mengkonfirmasi email mereka terlebih dahulu.
  • Fitur Bagikan Online dan Salin Tautan memulai proses berbagi dan menyimpan tautan ke papan klip. Salin Undangan menyalin pesan siap kirim beserta tautannya.
  • Klik "Hentikan Berbagi Online" di situs, "Hentikan Semua" di bilah berbagi, atau "Hentikan Semua Berbagi" di bilah menu akan menghentikannya sekaligus. Tautan tersebut akan berhenti berfungsi.

Halaman WordPress, gambar, dan tautan masuk mengikuti alamat mana pun yang digunakan pengunjung.

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:

list_sitessite_infostatusstart_servicescreate_siteclone_site list_versionsset_phpset_php_settingset_xdebugmove_database list_pluginslink_pluginunlink_pluginset_plugin_active set_debugread_logsclear_logsrun_phpread_mail backup_siterestore_sitelogin_urliphone_screenshot share_onlineshare_on_network

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 | statusLayanan kontrol
dokter meja colokanTampilkan alat yang terdeteksi
versi plugbenchDaftar 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 plugbenchDaftar 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|matiXdebug pada port 9003
plugbench move-db<slug><formula>Pindahkan basis data, atau default
plugbench https<slug> hidup|matiHTTPS 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|matiPencatatan 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 plugbenchDaftar 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 plugbenchAlamat Adminer
plugbench share on|offBerbagi Wi-Fi
plugbench share-online<slug> [email|berhenti]Tautan publik
plugbench iphone<slug> [jalur]Simulator dan tangkapan layar
resep plugbenchDaftar resep
lisensi plugbench [aktifkan]<key> | nonaktifkan]Lisensi
plugbench mcpJalankan 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

BebasPro, $29 sekali bayar
Situs3Tak terbatas
Semua versi CMS, PHP dan basis data, Xdebug, HTTPS, cadangan, phpMyAdmin, MailpitYaYa
Berbagi secara daring dan melalui Wi-FiYa
Alat iPhoneYa
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
ServerHomebrew, /opt/homebrew

Pelabuhan

Situs8801 ke atas; HTTPS pada port yang sama + 1000
phpMyAdmin8799
Adminer8800
Mailpit8025 (web), 1025 (SMTP)
MariaDB, default3307
Server basis data lainnya3308 dan seterusnya
Redis, Memcached, PostgreSQL6379, 11211, 5433
Xdebug9003 (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.