PHP

PHP is a popular scripting language that is especially suited for web development. It is often served by either apache or nginx.

You can easily add it to your Lando app by adding an entry to the services top-level config in your Landofile.

services:
  myservice:
    type: php:8.0
    via: nginx
    webroot: www

Supported versions

• 8.3 (experimental)
• 8.2
• 8.1
• 8.0
• 7.4 (default)
• 7.3
• custom

Legacy versions

Using Unsupported PHP Versions!

While you can currently use some EOL php version with Lando, it's worth noting that we also do not support such versions, so your mileage may vary. If you are having issues with unsupported versions and open a ticket about it, the most likely response you will get is "upgrade to a supported version".

You can still run these versions with Lando but for all intents and purposes they should be considered deprecated (e.g. YMMV and do not expect a ton of support if you have an issue).

• 7.2
• 7.1
• 7.0
• 5.6
• 5.5
• 5.4
• 5.3

Patch versions

Because we use our own custom images for php, specifying a patch version is not currently supported.

If you really need to lock down to a patch version, you could consider using either a custom compose service or a service overrides.

Custom Installation

This plugin is included with Lando by default. That means if you have Lando version 3.0.8 or higher then this plugin is already installed!

However if you would like to manually install the plugin, update it to the bleeding edge or install a particular version then use the below. Note that this installation method requires Lando 3.5.0+.

lando plugin-add @lando/php

# @TODO
# @NOTE: This doesn't actaully work yet
hyperdrive install @lando/php

# Ensure you have a global plugins directory
mkdir -p ~/.lando/plugins

# Install plugin
# NOTE: Modify the "npm install @lando/php" line to install a particular version eg
# npm install @lando/php@0.5.2
docker run --rm -it -v ${HOME}/.lando/plugins:/plugins -w /tmp node:16-alpine sh -c \
  "npm init -y \
  && npm install @lando/php --production --flat --no-default-rc --no-lockfile --link-duplicates \
  && npm install --production --cwd /tmp/node_modules/@lando/php \
  && mkdir -p /plugins/@lando \
  && mv --force /tmp/node_modules/@lando/php /plugins/@lando/php"

# Rebuild the plugin cache
lando --clear

You should be able to verify the plugin is installed by running lando config --path plugins and checking for @lando/php. This command will also show you where the plugin is being loaded from.