Caveats

Path Considerations

Lando will set the PATH hierarchy for this service as follows:

[
  # The line below should be where your app's composer.json binaries live
  '/app/vendor/bin',
  '/app/bin',
  '/usr/local/sbin',
  '/usr/local/bin',
  '/usr/sbin',
  '/usr/bin',
  '/sbin',
  '/bin',
  # The line below should be where global composer binaries live
  '/var/www/.composer/vendor/bin',
]

This is useful to note if you are not using absolute paths in any tooling routes and are getting the unexpected version of a particular utility.

Database Client Compatibility

When connecting to MySQL or MariaDB databases, you may encounter issues if the client version doesn't match your database server:

• MySQL 8.4+: Removed the mysql_native_password authentication plugin, requiring a MySQL 8.x client
• MariaDB 10.11+: Deprecated the mysql command in favor of mariadb, causing warning messages
• MariaDB 11.x clients: Require TLS by default. Lando writes disable-ssl-verify-server-cert to lando.cnf and also installs PATH wrappers that add --skip-ssl-verify-server-cert, so tools that pass --defaults-file (for example Drush sql:*) can still reach local databases that do not speak TLS. Rebuild the PHP service to apply.

For PHP 8.3+, Lando automatically detects your database service and installs a compatible client. See Database client configuration for details.

For older PHP versions, you may need to work around these issues manually or use tooling commands that connect from a compatible container.