@lando/laravel 1.12.0 → 1.12.1

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,10 @@
 ## {{ UNRELEASED_VERSION }} - [{{ UNRELEASED_DATE }}]({{ UNRELEASED_LINK }})
 
-## v1.12.0 - [February 19, 2026](https://github.com/lando/laravel/releases/tag/v1.12.0)
+## v1.12.1 - [February 22, 2026](https://github.com/lando/laravel/releases/tag/v1.12.1)
+
+* 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 18, 2026](https://github.com/lando/laravel/releases/tag/v1.12.0)
+## 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,14 @@
 ## {{ UNRELEASED_VERSION }} - [{{ UNRELEASED_DATE }}]({{ UNRELEASED_LINK }})
 
+## 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/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.1",
   "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-YARvLV+LsZ5LloDW2E7r3stkptHPkCtMh7VrEQu7Wa0pNF1N8TAQJlGxIRrWWuVT/6N7mgw+IWgro3CtPlCKsw==",
+    "shasum": "74c9af6bc8853760d8ca3a57528658580f99e409",
+    "filename": "lando-php-1.11.1.tgz",
+    "unpackedSize": 3059346
   }
 }

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

@@ -35,8 +35,8 @@ default-character-set=utf8mb4
 disable-ssl-verify-server-cert
 
 [mysqldump]
-# Prevent column-statistics errors with newer mysqldump
-skip-column-statistics
+# MySQL 8 uses this; MariaDB safely ignores it via loose- prefix
+loose-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.1",
   "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.1",
     "@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-CKW0am1RSHeXCeg3OCF9sJ7phPZCq5a3OiY9yS31+2haf7k8w20DPlqTTjAu811rAwfkOKtPjeG3IbGilBVQEg==",
+    "shasum": "e96504b6bc144a881a50d0d10d2e3db298619ea1",
+    "filename": "lando-laravel-1.12.1.tgz",
+    "unpackedSize": 13203935
   }
 }