Runtime per Proyek di FlyEnv

FlyEnv memungkinkan setiap folder proyek membawa versi runtime sendiri, sehingga basis kode PHP lama dan aplikasi Node.js modern dapat hidup berdampingan di komputer yang sama. Lihat mengelola beberapa versi Node dan PHP untuk sisi manajer versi. Daftarkan proyek di tab Proyek modul bahasa apa pun, pilih versi binari yang tepat, dan FlyEnv mencatat pilihan itu di dalam proyek. Sejak saat itu, terminal, editor, dan perintah yang dijalankan untuk proyek tersebut otomatis menggunakan toolchain yang benar. Alur langkah demi langkah tersedia di panduan lingkungan runtime tingkat proyek.

Cara kerja .flyenv

Saat Anda menambahkan proyek atau mengubah versi terikatnya, FlyEnv menulis berkas kecil .flyenv ke direktori proyek. Berkas itu menjadi satu-satunya sumber kebenaran lingkungan proyek.

• Menambahkan PATH di depan: di macOS dan Linux, berkas berisi baris export PATH="<bin>:<bin>/bin:<bin>/sbin:$PATH" yang menunjuk direktori runtime terikat; di Windows digunakan penetapan PowerShell $env:PATH yang setara.
• Bertanda dan idempoten: setiap baris yang ditulis FlyEnv diberi tag #FlyEnv-ID-<projectId>, sehingga pengeditan ulang menulis baris yang sama di tempatnya, bukan menambahkan duplikat.
• Per modul bahasa: tab Proyek digunakan bersama modul bahasa—PHP, NodeJS, Python, Go, Ruby, Rust, Java, .NET, Bun, Deno, dan lainnya—namun setiap modul menyimpan daftar proyek dan versi terikatnya sendiri.
• Dapat diedit di aplikasi: berkas .flyenv dapat dibuka dan disesuaikan dari tampilan konfigurasi proyek jika Anda memerlukan sesuatu di luar entri PATH bawaan.

Hook shell untuk zsh, bash, dan PowerShell

Berkas .flyenv berlaku melalui hook shell yang dipasang FlyEnv di berkas startup shell.

• zsh dan bash di macOS/Linux: FlyEnv mengambil skrip pembantu dari ~/.zshrc dan ~/.bashrc. Hook memantau perubahan direktori dan, saat Anda cd ke proyek terdaftar, mengambil berkas .flyenv proyek itu—sehingga php -v atau node -v segera melaporkan versi terikat.
• Hanya direktori dalam daftar izin: hook hanya mengaktifkan berkas .flyenv untuk direktori proyek yang telah didaftarkan dan disinkronkan FlyEnv ke daftar izin; berkas asing di lokasi lain tidak pernah dieksekusi.
• PowerShell di Windows: mekanisme yang sama ditautkan ke profil PowerShell, mencakup Windows PowerShell dan PowerShell (pwsh).

Integrasi IDE dan terminal

Karena pengikatan berada di proyek, bukan pengaturan global, alat apa pun yang dijalankan pada folder tersebut mewarisi lingkungan yang benar.

• Tindakan buka: setiap baris proyek menyediakan pintasan membuka folder di terminal atau IDE—Terminal dan PowerShell, serta editor seperti VSCode, PhpStorm, WebStorm, PyCharm, atau Sublime sesuai modul bahasa—dengan lingkungan proyek sudah diterapkan.
• Jalankan sebagai layanan: proyek dapat dijalankan langsung dari FlyEnv dengan perintah mulai atau berkas run khusus, port pilihan (bawaan 3000, ditautkan sebagai http://127.0.0.1:<port>), dan variabel lingkungan tambahan yang diberikan sebaris atau melalui berkas env; berguna agar server pengembangan tetap hidup tanpa jendela terminal.
• Edit cepat: klik dua kali baris proyek membuka editor ringkas untuk versi terikat, port, dan komentar, sehingga pergantian runtime proyek hanya membutuhkan beberapa detik.

Pemilihan versi per situs

Pengikatan proyek berlaku untuk baris perintah; situs yang diakses melalui browser memiliki pilihan versi sendiri. Setiap situs yang dibuat di modul Host memilih versi PHP-FPM yang melayaninya (atau tetap menjadi situs statis). Beberapa versi PHP-FPM dapat berjalan bersamaan, masing-masing pada soket sendiri, sehingga situs berbeda dilayani build PHP berbeda pada waktu yang sama. Daftar situs menampilkan versi yang melayani tiap situs, dan konfigurasi integrasi server web dibuat ulang saat versi dimulai. Kemampuan lengkap dijelaskan di halaman fitur PHP.

Panduan, solusi, dan demo terkait

Lanjutkan dengan panduan, solusi, demo, atau perspektif komunitas.

Panduan

• Project-level runtime isolation
• Manage Node.js and PHP versions

Solusi

• Run Laravel locally

Demo

• Browse project runtime demos

Komunitas

• Community: managing PHP and Node.js for Laravel and Next.js

Catatan kompatibilitas

Hook shell memerlukan shell login yang didukung: zsh atau bash di macOS/Linux, dan PowerShell (Windows PowerShell atau pwsh) di Windows; shell lain tidak di-hook otomatis. Hook hanya mengambil berkas .flyenv untuk direktori yang terdaftar di FlyEnv dan mengubah PATH pada sesi shell saat ini; variabel lingkungan sistem global tidak berubah. Pengikatan versi memilih runtime yang telah dipasang atau ditambahkan di FlyEnv, bukan menyediakan versi yang belum ada di komputer. Pemilihan PHP per situs berlaku untuk situs yang dilayani PHP-FPM (FastCGI di Windows); situs statis dan runtime non-PHP tidak menggunakannya. Perbedaan platform—seperti soket Unix di macOS/Linux dibanding worker FastCGI di Windows—mengikuti perilaku modul PHP. Halaman Unduhan mencerminkan komponen yang tersedia untuk sistem operasi Anda.