lumide_php #

Comprehensive PHP language support and development tooling plugin for Lumide IDE.

Prerequisites #

Before using the PHP plugin, make sure the following tools are installed on your system:

1. PHP Runtime (>= 8.0) — Required #

The plugin relies on the php CLI binary for syntax linting (php -l), built-in web server (php -S), direct script execution, and test runners.

• macOS (Homebrew):

  brew install php
  

• Ubuntu / Debian:

  sudo apt update && sudo apt install php-cli php-mbstring php-xml php-curl
  

• Arch Linux:

  sudo pacman -S php
  

• Windows:
  • Download from windows.php.net (Thread Safe or Non-Thread Safe x64 ZIP) and add to PATH, or install via:

  choco install php
  # or
  scoop install php
  

2. PHP Language Server (LSP) — Recommended for Code Intelligence #

For rich IDE features such as code completions, hover documentation, parameter hints, go-to-definition, and workspace diagnostics:

• Intelephense (Recommended — Fast & Full-featured): Requires Node.js:

  npm install -g intelephense
  

  (Alternatively, click Install Intelephense (npm) from the PHP Tools menu inside Lumide).

• Phpactor (PHP-native Language Server & Refactoring Tool): Requires PHP >= 8.2:

  # Install globally with Composer:
  composer global require phpactor/phpactor
  
  # Or install standalone PHAR directly inside Lumide:
  # Click "Install Phpactor (Standalone PHAR)" in the PHP Tools menu.
  

• PHP Language Server (felixfbecker/php-language-server):

  composer global require felixfbecker/language-server
  

3. Composer — Recommended for Project Management #

Required for dependency management, autoloading, running Composer scripts, and project-local tools:

• macOS: brew install composer
• Linux / Windows: Follow instructions on getcomposer.org/download or:

  choco install composer
  

4. Code Formatters & Test Runners — Optional #

The plugin automatically discovers and runs tools installed locally in vendor/bin/ (or from global PATH):

Features #

🐘 Language Server Protocol (LSP) #

Connects seamlessly with PHP Language Servers for rich IDE features (completions, parameter hints, go-to-definition, hover docs, workspace symbols, diagnostics):

• Intelephense (intelephense --stdio) — Fast, full-featured default PHP language server.
• Phpactor (phpactor language-server) — Powerful PHP-native language server and refactoring toolkit.
• PHP Language Server (php-language-server) — Pure PHP language server.
• Custom Executable — Use your own custom PHP language server binary or path.
• Auto-Detection — Automatically finds installed LSP servers in PATH.
• Switch Engine on the Fly (PHP: Select Language Server).

📦 Composer Integration #

• Composer: Install — Run composer install in an integrated terminal.
• Composer: Update — Run composer update.
• Composer: Dump Autoload — Run optimized classmap generation (composer dump-autoload -o).
• Composer: Validate — Validate composer.json format and dependencies.
• Composer: Require Package — Interactively search and install PHP packages.
• Composer: Run Script... — Interactive quick-pick menu of all custom scripts defined in composer.json.
• File tree context menu integrations for composer.json.

🌐 Built-in Web Server #

• PHP: Start Built-in Web Server — Quickly spin up php -S <host>:<port> without leaving Lumide.
• PHP: Stop Built-in Web Server — Stop the running development server.
• PHP: Open Server in Browser — One-click preview in default browser.
• Status bar server indicator displaying port and state.

🧪 Test Runner (PHPUnit & Pest) #

• PHP: Run All Tests — Automatically detects and runs Pest or PHPUnit.
• PHP: Run Current Test File — Run tests specifically for the active open file.

🎨 Linting & Code Formatting #

• PHP: Lint Active File (php -l) — Instant syntax checking.
• PHP: Format Active File — Automatically formats using Laravel Pint (pint) or PHP-CS-Fixer (php-cs-fixer).

Configuration #

Getting Started #

1. Open any workspace containing PHP files (.php) or composer.json in Lumide IDE.
2. The PHP plugin activates automatically. Click the PHP logo icon in the bottom right status bar to open the PHP Tools Menu or switch language server engines.