在macos上为frankenphp v1.4启用pdo_mysql扩展必须通过docker容器操作，因官方不提供原生二进制包；需使用dunglas/frankenphp:1.4（apache或fpm标签）镜像，运行install-php-extensions pdo_mysql一键安装，或改用预装扩展的1.4-apache镜像。
在macOS上为FrankenPHP v1.4安装pdo_mysql扩展，核心难点在于FrankenPHP不走传统PHP的php.ini启用路径，也不支持pecl或apt类包管理；它依赖静态构建时预编译或运行时动态加载机制，而macOS原生无官方FrankenPHP二进制包，必须通过Docker容器方式运行——直接在宿主macOS系统里“安装扩展”这个动作本身就不成立。
确认你用的是FrankenPHP Docker镜像
FrankenPHP官方未提供macOS原生可执行文件，v1.4所有稳定使用场景均基于Docker。打开终端，执行：docker images | grep dunglas/frankenphp。若无输出，说明你还没拉取镜像，需先运行docker pull dunglas/frankenphp:1.4。【不是dunglas/frankenphp镜像的任何自定义构建，都无法使用install-php-extensions命令】
进入容器并验证当前扩展状态
启动一个临时容器：docker run -it --rm dunglas/frankenphp:1.4 bash。进容器后立即执行：php -m | grep -E '^(pdo|pdo_mysql)$'。如果只看到pdo而没有pdo_mysql，说明该镜像tag默认未启用MySQL驱动——这正是v1.4基础镜像的典型行为。
用install-php-extensions一键安装（推荐）
在已进入的容器bash中，直接运行：
install-php-extensions pdo_mysql
这条命令会自动下载、编译、安装pdo_mysql.so，并写入conf.d目录下的启用配置。它比手动改php.ini可靠得多，因为FrankenPHP的$PHP_INI_DIR下php.ini-production默认禁用所有扩展，而install-php-extensions生成的/usr/local/etc/php/conf.d/docker-php-ext-pdo_mysql.ini具有更高加载优先级。安装完成后，执行php -m | grep pdo_mysql应有回显。
若提示command not found，切换镜像版本
方法一：改用带扩展预装的变体镜像docker run -it --rm dunglas/frankenphp:1.4-apache php -m | grep pdo_mysql——该镜像内置了常用扩展，通常已含pdo_mysql。
方法二：降级到更稳定的1.3.x基础镜像（兼容性更强）docker pull dunglas/frankenphp:1.3，再按前述流程操作。
【FrankenPHP 1.4的static-builder-musl镜像不含install-php-extensions工具，仅apache/fpm标签才内置】
验证PDO连接能力
仍在容器内，创建测试文件：echo "<?php \$d = new PDO('mysql:host=host.docker.internal;dbname=test', 'root', ''); print_r(\$d->getAvailableDrivers());" > test-pdo.php。然后执行：php test-pdo.php。若输出包含mysql且无Fatal错误，说明pdo_mysql已就绪。注意：host.docker.internal是macOS Docker Desktop提供的宿主MySQL服务别名，确保你的MySQL服务正运行在宿主3306端口。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
