@lando/laravel 1.12.0 → 1.12.2

package/AGENTS.md

@@ -0,0 +1,117 @@
+# AGENTS.md
+
+This file provides guidance to AI coding assistants when working with code in this repository.
+
+## Project Overview
+
+This is the official Lando plugin for Laravel (`@lando/laravel`). It provides a recipe that configures PHP, web server, database, and caching services for Laravel development environments.
+
+## Common Commands
+
+```bash
+# Install dependencies
+npm install
+
+# Run linting
+npm run lint
+
+# Run unit tests
+npm run test:unit
+
+# Run both lint and unit tests
+npm test
+
+# Run integration tests (Leia)
+npm run test:leia
+
+# Run a single integration test
+npx leia examples/laravel-defaults/README.md -c 'Destroy tests'
+
+# Documentation development
+npm run docs:dev      # Start dev server
+npm run docs:build    # Build docs
+```
+
+## Architecture
+
+### Plugin Structure
+
+- **builders/** - Service builders that extend Lando's base services
+  - `laravel.js` - Main recipe builder, configures all services and tooling
+  - `laravel-php.js`, `laravel-nginx.js`, `laravel-mysql.js`, etc. - Service-specific builders that extend `@lando/php`, `@lando/mysql`, etc.
+
+- **config/** - Configuration templates
+  - `default.conf.tpl` - Nginx vhost template
+  - `php.ini`, `mysql.cnf`, `mysql8.cnf` - Service configs
+
+- **inits/** - Initialization logic for `lando init` command
+
+- **examples/** - Working Lando apps for development and testing. Each example has a `plugins: "@lando/laravel": ../..` directive to use the local source.
+
+- **test/** - Unit tests (Mocha/Chai). Name files as `*.spec.js`.
+
+### Recipe Configuration Flow
+
+The main `builders/laravel.js` exports a recipe that:
+1. Accepts user config (php version, database type, cache, via, webroot, xdebug)
+2. Merges defaults with user overrides
+3. Configures services: appserver (PHP), database, optional cache
+4. Sets up tooling: composer, php, artisan, db-import/export, database CLI
+
+### Dependencies
+
+This plugin depends on other Lando service plugins:
+- `@lando/php` - PHP/Apache/Nginx services
+- `@lando/mysql`, `@lando/mariadb`, `@lando/postgres`, `@lando/mssql` - Databases
+- `@lando/redis`, `@lando/memcached` - Caching
+
+## Testing
+
+### Unit Tests
+Place in `test/` with `.spec.js` extension. Run with `npm run test:unit`.
+
+### Leia Integration Tests
+Integration tests are written as shell commands in markdown (example READMEs). The markdown follows a specific format with "Start up tests", "Verification commands", and "Destroy tests" sections. See `examples/*/README.md` for examples.
+
+**Note:** Integration tests in `examples/` are run by the `pr-laravel-tests.yml` GitHub Actions workflow on pull requests, but only if they are explicitly listed in the workflow's test matrix. New examples must be added to the matrix in `pr-laravel-tests.yml` to be included in CI.
+
+## GitHub Actions
+
+CI/CD workflows are defined in `.github/workflows/`:
+
+### PR Workflows (run on every pull request)
+
+| Workflow | File | Purpose |
+|----------|------|---------|
+| **Laravel Tests** | `pr-laravel-tests.yml` | Runs Leia integration tests for examples explicitly listed in the workflow matrix. Tests against Lando 3-edge and 3-stable on Ubuntu. |
+| **Unit Tests** | `pr-unit-tests.yml` | Runs `npm run test:unit` across Windows, Ubuntu, and macOS. |
+| **Lint Code** | `pr-linter.yml` | Runs `npm run lint` to check code style. |
+| **Docs Tests** | `pr-docs-tests.yml` | Builds documentation to verify no broken builds. |
+
+### Release Workflow
+
+| Workflow | File | Purpose |
+|----------|------|---------|
+| **Publish to NPM** | `release.yml` | Triggered on GitHub release creation. Runs lint + unit tests, then publishes to npm. Stable releases go to `latest` tag; prereleases go to `edge` tag. |
+
+### Integration Test Matrix
+
+The `pr-laravel-tests.yml` workflow explicitly lists which examples to test. New examples must be added to this list to run in CI.
+
+Each test runs against the example's `README.md` using the [Leia](https://github.com/lando/leia) test runner.
+
+## Development Workflow
+
+1. Use examples directory - apps there reference the local plugin source
+2. To test against an external app, add to its Landofile:
+   ```yaml
+   plugins:
+     "@lando/laravel": /path/to/this/plugin
+   ```
+
+## Code Style
+
+- ESLint with Google config, max 140 char lines
+- Node.js 20+
+- JSDoc required for function declarations
+- 2-space indentation

package/CHANGELOG.md

@@ -1,8 +1,14 @@
 ## {{ UNRELEASED_VERSION }} - [{{ UNRELEASED_DATE }}]({{ UNRELEASED_LINK }})
 
-## v1.12.0 - [February 19, 2026](https://github.com/lando/laravel/releases/tag/v1.12.0)
+## v1.12.2 - [February 25, 2026](https://github.com/lando/laravel/releases/tag/v1.12.2)
+
+* Updated to [@lando/php@1.11.2](https://github.com/lando/php/releases/tag/v1.11.2) for composer install fix and MariaDB mysqldump compatibility.
+
+## v1.12.1 - [February 22, 2026](https://github.com/lando/laravel/releases/tag/v1.12.1)
 
-## v1.12.0 - [February 18, 2026](https://github.com/lando/laravel/releases/tag/v1.12.0)
+* Updated to [@lando/php@1.11.1](https://github.com/lando/php/releases/tag/v1.11.1) for PHP 8.5 support, database client auto-detection, and more.
+
+## v1.12.0 - [February 19, 2026](https://github.com/lando/laravel/releases/tag/v1.12.0)
 
 * Updated to [@lando/php@1.10.0](https://github.com/lando/php/releases/tag/v1.10.0)
 * Fixed release workflow to trigger on `published` instead of `created` events

package/node_modules/@lando/php/CHANGELOG.md

@@ -1,5 +1,21 @@
 ## {{ UNRELEASED_VERSION }} - [{{ UNRELEASED_DATE }}]({{ UNRELEASED_LINK }})
 
+## v1.11.2 - [February 25, 2026](https://github.com/lando/php/releases/tag/v1.11.2)
+
+* Fixed composer install crash caused by legacy prestissimo removal running as wrong user
+* Improved composer install script to default to latest stable
+* Fixed `mysqldump` warning for unknown option on MariaDB 11.4/11.8 [#237](https://github.com/lando/php/issues/237)
+* Updated to [@lando/nginx@1.6.0](https://github.com/lando/nginx/releases/tag/v1.6.0)
+
+## v1.11.1 - [February 20, 2026](https://github.com/lando/php/releases/tag/v1.11.1)
+
+* Fixed database type detection when no version is specified
+* Added npm edge-to-latest tag promotion on release
+
+## v1.11.0 - [February 19, 2026](https://github.com/lando/php/releases/tag/v1.11.0)
+
+* Fixed database client auto-detection for recipe-based services [#223](https://github.com/lando/php/pull/223)
+
 ## v1.10.0 - [February 18, 2026](https://github.com/lando/php/releases/tag/v1.10.0)
 
 * Added database client auto-detection and version matching [#212](https://github.com/lando/php/pull/212)

package/node_modules/@lando/php/builders/php.js

@@ -68,12 +68,12 @@ const detectDatabaseClient = (options, debug = () => {}) => {
 
   for (const service of Object.values(services)) {
     const type = service?.type || '';
-    // Match mysql:X, mysql:X.Y, or mysql:X.Y.Z formats
-    const mysqlMatch = type.match(/^mysql:(\d+(?:\.\d+)?)/);
-    if (mysqlMatch && !mysqlVersion) mysqlVersion = mysqlMatch[1];
-    // Match mariadb:X, mariadb:X.Y, or mariadb:X.Y.Z formats
-    const mariaMatch = type.match(/^mariadb:(\d+(?:\.\d+)?)/);
-    if (mariaMatch && !mariaVersion) mariaVersion = mariaMatch[1];
+    // Match mysql or mysql:X, including recipe prefixes (e.g., backdrop-mysql, backdrop-mysql:8.0)
+    const mysqlMatch = type.match(/(?:^|-)mysql(?::(\d+(?:\.\d+)?))?(?:$|[^a-z])/);
+    if (mysqlMatch && !mysqlVersion) mysqlVersion = mysqlMatch[1] || '8.0';
+    // Match mariadb or mariadb:X, including recipe prefixes (e.g., backdrop-mariadb:10.6)
+    const mariaMatch = type.match(/(?:^|-)mariadb(?::(\d+(?:\.\d+)?))?(?:$|[^a-z])/);
+    if (mariaMatch && !mariaVersion) mariaVersion = mariaMatch[1] || '11.4';
   }
 
   if (mariaVersion && mysqlVersion) {

package/node_modules/@lando/php/images/8.3-apache/Dockerfile

@@ -65,6 +65,10 @@ COPY --from=mysql-client-84 /usr/bin/mysql /usr/local/mysql-client/8.4/mysql
 COPY --from=mysql-client-84 /usr/bin/mysqldump /usr/local/mysql-client/8.4/mysqldump
 COPY --from=mysql-client-84 /usr/bin/mysqladmin /usr/local/mysql-client/8.4/mysqladmin
 
+# Ensure required MySQL client shared libraries are present
+COPY --from=mysql-client-80 /usr/lib64/libmysqlclient.so* /usr/lib/
+COPY --from=mysql-client-84 /usr/lib64/libmysqlclient.so* /usr/lib/
+
 RUN \
   chsh -s /bin/bash www-data && mkdir -p /var/www/.composer && chown -R www-data:www-data /var/www \
   && apt-get -y clean \

package/node_modules/@lando/php/images/8.3-fpm/Dockerfile

@@ -65,6 +65,10 @@ COPY --from=mysql-client-84 /usr/bin/mysql /usr/local/mysql-client/8.4/mysql
 COPY --from=mysql-client-84 /usr/bin/mysqldump /usr/local/mysql-client/8.4/mysqldump
 COPY --from=mysql-client-84 /usr/bin/mysqladmin /usr/local/mysql-client/8.4/mysqladmin
 
+# Ensure required MySQL client shared libraries are present
+COPY --from=mysql-client-80 /usr/lib64/libmysqlclient.so* /usr/lib/
+COPY --from=mysql-client-84 /usr/lib64/libmysqlclient.so* /usr/lib/
+
 RUN \
   chsh -s /bin/bash www-data && mkdir -p /var/www/.composer && chown -R www-data:www-data /var/www \
   && apt-get -y clean \

package/node_modules/@lando/php/images/8.4-apache/Dockerfile

@@ -65,6 +65,10 @@ COPY --from=mysql-client-84 /usr/bin/mysql /usr/local/mysql-client/8.4/mysql
 COPY --from=mysql-client-84 /usr/bin/mysqldump /usr/local/mysql-client/8.4/mysqldump
 COPY --from=mysql-client-84 /usr/bin/mysqladmin /usr/local/mysql-client/8.4/mysqladmin
 
+# Ensure required MySQL client shared libraries are present
+COPY --from=mysql-client-80 /usr/lib64/libmysqlclient.so* /usr/lib/
+COPY --from=mysql-client-84 /usr/lib64/libmysqlclient.so* /usr/lib/
+
 RUN \
   chsh -s /bin/bash www-data && mkdir -p /var/www/.composer && chown -R www-data:www-data /var/www \
   && apt-get -y clean \

package/node_modules/@lando/php/images/8.4-fpm/Dockerfile

@@ -66,6 +66,10 @@ COPY --from=mysql-client-84 /usr/bin/mysql /usr/local/mysql-client/8.4/mysql
 COPY --from=mysql-client-84 /usr/bin/mysqldump /usr/local/mysql-client/8.4/mysqldump
 COPY --from=mysql-client-84 /usr/bin/mysqladmin /usr/local/mysql-client/8.4/mysqladmin
 
+# Ensure required MySQL client shared libraries are present
+COPY --from=mysql-client-80 /usr/lib64/libmysqlclient.so* /usr/lib/
+COPY --from=mysql-client-84 /usr/lib64/libmysqlclient.so* /usr/lib/
+
 RUN \
   chsh -s /bin/bash www-data && mkdir -p /var/www/.composer && chown -R www-data:www-data /var/www \
   && apt-get -y clean \

package/node_modules/@lando/php/images/8.5-apache/Dockerfile

@@ -65,6 +65,10 @@ COPY --from=mysql-client-84 /usr/bin/mysql /usr/local/mysql-client/8.4/mysql
 COPY --from=mysql-client-84 /usr/bin/mysqldump /usr/local/mysql-client/8.4/mysqldump
 COPY --from=mysql-client-84 /usr/bin/mysqladmin /usr/local/mysql-client/8.4/mysqladmin
 
+# Ensure required MySQL client shared libraries are present
+COPY --from=mysql-client-80 /usr/lib64/libmysqlclient.so* /usr/lib/
+COPY --from=mysql-client-84 /usr/lib64/libmysqlclient.so* /usr/lib/
+
 RUN \
   chsh -s /bin/bash www-data && mkdir -p /var/www/.composer && chown -R www-data:www-data /var/www \
   && apt-get -y clean \

package/node_modules/@lando/php/images/8.5-fpm/Dockerfile

@@ -66,6 +66,10 @@ COPY --from=mysql-client-84 /usr/bin/mysql /usr/local/mysql-client/8.4/mysql
 COPY --from=mysql-client-84 /usr/bin/mysqldump /usr/local/mysql-client/8.4/mysqldump
 COPY --from=mysql-client-84 /usr/bin/mysqladmin /usr/local/mysql-client/8.4/mysqladmin
 
+# Ensure required MySQL client shared libraries are present
+COPY --from=mysql-client-80 /usr/lib64/libmysqlclient.so* /usr/lib/
+COPY --from=mysql-client-84 /usr/lib64/libmysqlclient.so* /usr/lib/
+
 RUN \
   chsh -s /bin/bash www-data && mkdir -p /var/www/.composer && chown -R www-data:www-data /var/www \
   && apt-get -y clean \

package/node_modules/@lando/php/node_modules/@lando/nginx/CHANGELOG.md

@@ -1,5 +1,7 @@
 ## {{ UNRELEASED_VERSION }} - [{{ UNRELEASED_DATE }}]({{ UNRELEASED_LINK }})
 
+## v1.6.0 - [February 23, 2026](https://github.com/lando/nginx/releases/tag/v1.6.0)
+
 ## v1.5.0 - [August 31, 2025](https://github.com/lando/nginx/releases/tag/v1.5.0)
 
 * Switched images to [bitnamilegacy](https://github.com/bitnami/containers/issues/83267) namespace

package/node_modules/@lando/php/node_modules/@lando/nginx/config/launch.sh

@@ -47,6 +47,15 @@ fi
 lando_info "Rendered template /tmp/vhosts.lando to /opt/bitnami/nginx/conf/vhosts/lando.conf"
 lando_debug $(cat /opt/bitnami/nginx/conf/vhosts/lando.conf)
 
+# Set nginx worker user to www-data so it can serve files created by PHP
+# Bitnami's nginx-env.sh hardcodes NGINX_DAEMON_USER=daemon which overwrites
+# any env var we set, so we patch it before the entrypoint runs
+# See: https://github.com/lando/drupal/issues/124
+if [ -f "/opt/bitnami/scripts/nginx-env.sh" ]; then
+  sed -i 's/export NGINX_DAEMON_USER="daemon"/export NGINX_DAEMON_USER="www-data"/' /opt/bitnami/scripts/nginx-env.sh
+  sed -i 's/export NGINX_DAEMON_GROUP="daemon"/export NGINX_DAEMON_GROUP="www-data"/' /opt/bitnami/scripts/nginx-env.sh
+fi
+
 # Detect and run the correct entrypoint script. THANKS BITNAMI!
 if [ -f "/opt/bitnami/scripts/nginx/entrypoint.sh" ]; then
   /opt/bitnami/scripts/nginx/entrypoint.sh /opt/bitnami/scripts/nginx/run.sh

package/node_modules/@lando/php/node_modules/@lando/nginx/netlify.toml

@@ -10,7 +10,7 @@
 [[context.deploy-preview.plugins]]
   package = "netlify-plugin-checklinks"
   [context.deploy-preview.plugins.inputs]
-    todoPatterns = [ "load", "CHANGELOG.html", "x.com", "twitter.com", "/v/" ]
+    todoPatterns = [ "load", "CHANGELOG.html", "x.com", "twitter.com", "/v/", "hub.docker.com" ]
     skipPatterns = [ ".rss", ".gif", ".jpg" ]
     checkExternal = true
 

package/node_modules/@lando/php/node_modules/@lando/nginx/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lando/nginx",
   "description": "A Lando plugin that provides a tight integration with NGINX.",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "author": "Mike Pirog @pirog",
   "license": "MIT",
   "repository": "lando/nginx",
@@ -62,9 +62,9 @@
     "lodash"
   ],
   "dist": {
-    "integrity": "sha512-5ucFuVSujqYHcrRYfp7h7hJoeB4hDIykCa3jCSrOzXEh9yJA5tOoIHWZ6sA5bVWMZ+fmVjJwN4ECq5bCSL4fXQ==",
-    "shasum": "4f17dd1cd473fd82fffc629a87f09b695826bf75",
-    "filename": "lando-nginx-1.5.0.tgz",
-    "unpackedSize": 1438911
+    "integrity": "sha512-hFMXf957vKd++pvHh08Ywc8h2Aftg1uDg+4Pt4HqsTQxYSnlN8ayoOVYphV7cUe2WV1gRIbFCLz5pKAPak/bYQ==",
+    "shasum": "648e64c6fc22418c8cd65b6ebe3274d16a6dc115",
+    "filename": "lando-nginx-1.6.0.tgz",
+    "unpackedSize": 1439572
   }
 }

package/node_modules/@lando/php/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lando/php",
   "description": "A Lando plugin that provides a tight integration with PHP.",
-  "version": "1.10.0",
+  "version": "1.11.2",
   "author": "Mike Pirog @pirog",
   "license": "MIT",
   "repository": "lando/php",
@@ -66,9 +66,9 @@
     "semver"
   ],
   "dist": {
-    "integrity": "sha512-KI1gTQPz98mOetlZpUMjzxZas/yF8quXdzY9QCV+Yqe2FKmG+8vFgvCViMeiRzevKVXAVpfRiXb5InH3gnyq/g==",
-    "shasum": "85545d2e4b9dc77cc8b771899b1fbdb2e4883c4e",
-    "filename": "lando-php-1.10.0.tgz",
-    "unpackedSize": 3057365
+    "integrity": "sha512-Jn6jP037tdYErBJBdIectKZxAen896JEtQD7sM0/OIztjpogAS94m6AGLfGqlj9g13nPyg2X9m8jR8V7gyIzkw==",
+    "shasum": "3abc7d8bccedcaeb8edb0557dc920475dea2273c",
+    "filename": "lando-php-1.11.2.tgz",
+    "unpackedSize": 3060141
   }
 }

package/node_modules/@lando/php/scripts/install-composer.sh

@@ -24,17 +24,11 @@ elif [ "$VERSION" = 'preview' ]; then
   php /tmp/composer-setup.php --install-dir=/usr/local/bin --filename=composer --preview
 elif [ "$VERSION" = 'snapshot' ]; then
   php /tmp/composer-setup.php --install-dir=/usr/local/bin --filename=composer --snapshot
-else
+elif [ -n "$VERSION" ]; then
   php /tmp/composer-setup.php --install-dir=/usr/local/bin --filename=composer --version="$VERSION"
+else
+  php /tmp/composer-setup.php --install-dir=/usr/local/bin --filename=composer
 fi
 
 # Remove the setup script
 php -r "unlink('/tmp/composer-setup.php');"
-
-# Check if anything is installed globally
-if [ -f /var/www/.composer/composer.json ]; then
-  # If this is version 2 then let's make sure hirak/prestissimo is removed
-  if composer --version 2>/dev/null | grep -E "Composer (version )?2." > /dev/null; then
-    composer global remove hirak/prestissimo
-  fi
-fi

package/node_modules/@lando/php/scripts/mariadb-compat-install.sh

@@ -34,9 +34,6 @@ default-character-set=utf8mb4
 # Prevent SSL errors when connecting to servers without SSL
 disable-ssl-verify-server-cert
 
-[mysqldump]
-# Prevent column-statistics errors with newer mysqldump
-skip-column-statistics
 MYCNF
 
 echo "MariaDB compatibility wrappers installed"

package/node_modules/@lando/php/scripts/mysql-client-install.sh

@@ -50,10 +50,18 @@ mkdir -p /etc/mysql/conf.d
 cat > /etc/mysql/conf.d/lando.cnf << 'MYCNF'
 [client]
 default-character-set=utf8mb4
+# Use PREFERRED so SSL is used when available but self-signed certs
+# (e.g. MySQL 5.7 defaults) don't cause verification failures.
+# Preserves SSL for servers that support it
+ssl-mode=PREFERRED
 
 [mysqldump]
 # Prevent column-statistics errors with newer mysqldump
 skip-column-statistics
+ssl-mode=PREFERRED
 MYCNF
 
-mysql --version 2>/dev/null || echo "Warning: MySQL client not available"
+if ! mysql --version 2>/dev/null; then
+  echo "Error: MySQL client not available after activation"
+  exit 1
+fi

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lando/laravel",
   "description": "A Lando plugin that provides a tight integration with Laravel.",
-  "version": "1.12.0",
+  "version": "1.12.2",
   "author": "Mike Pirog @pirog",
   "license": "MIT",
   "repository": "lando/laravel",
@@ -47,7 +47,7 @@
     "@lando/memcached": "^1.4.2",
     "@lando/mssql": "^1.4.3",
     "@lando/mysql": "^1.6.0",
-    "@lando/php": "^1.10.0",
+    "@lando/php": "^1.11.2",
     "@lando/postgres": "^1.5.0",
     "@lando/redis": "^1.2.3",
     "lodash": "^4.17.21"
@@ -76,9 +76,9 @@
     "lodash"
   ],
   "dist": {
-    "integrity": "sha512-N2wjqLuha/X08scqiWRb0jq939h5sHYWQOH2wH0+1WRdpnsonXaw/6s8WhWOx5Kyfs97CzN/yNhGMIxtASTZ0Q==",
-    "shasum": "3fefbc807cdc413c0c2fab149889af655db8ce9e",
-    "filename": "lando-laravel-1.12.0.tgz",
-    "unpackedSize": 13197506
+    "integrity": "sha512-lWCfH0s93gFfWQnz92U6fTMEYan8+Q9IQJkEb2/JNXwo083hCgUvCIRcpB4aytsRDN9ttLYhD0L9eMXDfuIftg==",
+    "shasum": "d7f124ef83af7d808b64bf8b14ed44607262f3d7",
+    "filename": "lando-laravel-1.12.2.tgz",
+    "unpackedSize": 13204966
   }
 }