Skip to main content
Example Repo

​
Adding PHP to your Project​

Run devbox add php php83Packages.composer, or add the following to your devbox.json: 
    "packages": [
        "php@latest",
        "php83Packages.composer@latest"
    ]
If you want a different version of PHP for your project, you can search for available versions by running devbox search php. You can also view the available versions on Nixhub

​
Installing PHP Extensions​

You can compile additional extensions into PHP by adding them to packages in your devbox.json. Devbox will automatically ensure that your extensions are included in PHP at compile time. For example — to add the ds extension, run devbox add php83Extensions.ds, or update your packages to include the following: 
    "packages": [
        "php@latest",
        "php83Packages.composer",
        "php83Extensions.ds"
    ]

​
PHP Plugin Details​

The PHP Plugin will provide the following configuration when you install a PHP runtime with devbox add. You can also manually add the PHP plugin by adding plugin:php to your include list in devbox.json: 
    "include": [
        "plugin:php"
    ]

​
Services​

  • php-fpm
Use devbox services start|stop php-fpm to start PHP-FPM in the background.

​
Environment Variables​

PHPFPM_PORT=8082
PHPFPM_ERROR_LOG_FILE={PROJECT_DIR}/.devbox/virtenv/php/php-fpm.log
PHPFPM_PID_FILE={PROJECT_DIR}/.devbox/virtenv/php/php-fpm.pid
PHPRC={PROJECT_DIR}/devbox.d/php/php.ini

​
Helper Files​

  • {PROJECT_DIR}/devbox.d/php81/php-fpm.conf
  • {PROJECT_DIR}/devbox.d/php81/php.ini
You can modify these files to configure PHP or your PHP-FPM server

​
Disabling the PHP Plugin​

You can disable the PHP plugin by running devbox add php --disable-plugin, or by setting the disable_plugin field in your devbox.json: 
{
  "packages": {
    "php": {
      "version": "latest",
      "disable_plugin": true
    }
  }
}
Edit this page
⌘I