本文详细介绍了在 azure web app 环境中，如何正确启用 pdo_mysql扩展，以解决 php 应用（如 laravel）因缺少该驱动而导致的 数据库 连接错误。针对 ssh 与 kudu/bash终端中 php 模块列表不一致的问题，文章阐述了不同 php 运行环境配置文件的差异，并提供了定位、修改正确的 php.ini 文件及验证配置的步骤，确保您的 php 应用能够顺利连接 mysql 数据库。
Azure PHP Web 应用中 pdo_mysql 扩展的正确启用方法
在使用 Azure Web app部署 PHP 应用程序时，开发者可能会遇到一个常见问题：应用程序在本地运行正常，但在 Azure 上部署后，涉及数据库操作的页面却出现 http 500 错误。这通常是由于 Azure 环境中的 pdo_mysql 扩展未正确启用所致。尽管在 SSH 终端中执行 php - m 可能显示 pdo_mysql 已加载，但在 Kudu（Bash）终端或应用程序实际运行环境中，该扩展却可能缺失，导致laravel 等框架无法连接 MySQL 数据库。本文将深入探讨此问题的原因，并提供详细的解决方案。
理解 PHP 运行环境的差异
在 linux 系统上，PHP 通常有多种运行模式，每种模式可能使用独立的 php.ini 配置文件：
- CLI (Command Line Interface) 模式： 用于执行命令行脚本，例如 php artisan migrate。其配置文件通常位于 /etc/php/{version}/cli/php.ini。
- FPM (FastCGI Process Manager) 模式： 这是 Web 服务器（如nginx、apache）与 PHP 通信的主要方式，用于处理 HTTP 请求。其配置文件通常位于 /etc/php/{version}/fpm/php.ini。
- Web Server 模块模式： 对于 Apache 等直接作为模块加载 PHP 的情况，配置文件可能位于 /etc/php/{version}/apache2/php.ini。
在 Azure web app中，当您通过 SSH 连接时，php - m 命令通常反映的是 CLI 模式下的 PHP 配置。然而，您的 Web 应用程序通过 HTTP 请求运行时，使用的是 FPM 或 Web 服务器模块模式下的 PHP 配置。Kudu 终端（Bash）可能也指向一个不同的 PHP CLI 环境，或者其 环境变量 与实际 Web 运行环境不同，导致模块列表不一致。Oryx Builder 在构建应用程序时，同样会依赖于特定的 PHP CLI 环境，如果该环境中缺少 pdo_mysql，则可能导致构建失败或运行时错误。
因此，解决问题的关键在于定位并修改Web 服务器实际使用的 php.ini 文件。
立即学习“PHP 免费学习笔记（深入）”；
定位并修改 php.ini 文件
以下是启用 pdo_mysql 扩展的详细步骤：
步骤一：访问 Kudu 控制台
首先，您需要访问 Azure Web App 的 Kudu 控制台。您可以通过以下两种方式进入：
- 通过 Azure 门户： 导航到您的 App Service -> 开发 工具 -> 高级 工具 -> 前往。
- 直接访问 URL： https://< 您的应用名称 >.scm.azurewebsites.net
在 Kudu 控制台中，点击“Debug console”->“Bash”或“CMD”，进入命令行界面。
步骤二：查找 php.ini 文件
在 Kudu 控制台的命令行中，您需要查找 Web 服务器实际使用的 php.ini 文件。常见的路径包括：
- /etc/php/{version}/fpm/php.ini
- /etc/php/{version}/apache2/php.ini
- php -i | grep “Loaded Configuration File” 命令可以帮助您找到当前 CLI 环境加载的配置文件路径。然而，请注意这可能不是 Web 服务器使用的文件。
通常，对于 Azure 上的 PHP 应用，PHP-FPM 是常见的配置。您可以使用 find 命令进行搜索，或者直接检查常见路径：
# 查找所有 php.ini 文件 find / -name php.ini 2>/dev/null # 检查常见 FPM 路径 (请将 {version} 替换为您的 PHP 版本，例如 7.4, 8.0) ls /etc/php/7.4/fpm/php.ini一旦找到疑似的 php.ini 文件，您可以使用 cat 命令查看其内容，确认其是否包含或缺少extension=pdo_mysql。
步骤三：启用 pdo_mysql 扩展
找到正确的 php.ini 文件后，您需要编辑它以启用 pdo_mysql 扩展。在 Kudu 控制台中，您可以使用 vi 或 nano（如果可用）进行编辑，或者更简单的方法是使用 echo 命令追加内容。
- 备份原始文件（可选但推荐）：
cp /etc/php/{version}/fpm/php.ini /etc/php/{version}/fpm/php.ini.bak - 编辑文件： 找到类似；
extension=pdo_mysql的行（前面有分号表示注释掉），将其取消注释，即删除分号。如果找不到，则手动添加：extension=pdo_mysql如果您不熟悉 vi 或 nano，可以尝试使用 echo 命令追加到文件末尾（如果文件中不存在该行）：
echo "
extension=pdo_mysql" >> /etc/php/{version}/fpm/php.ini注意： 确保只添加一次，避免重复。如果文件中已有注释掉的行，最好是直接编辑。
步骤四：重启 Azure Web App
修改 php.ini 文件后，您需要重启 Azure Web App 以使更改生效。这可以通过 Azure 门户完成：
导航到您的 App Service -> 概述 -> 重启。
验证配置
重启应用后，您可以通过以下方法验证 pdo_mysql 扩展是否已成功启用：
- 创建 phpinfo 文件： 在您的 Web 应用程序的根目录（或任何可公开访问的目录）创建一个名为 info.php 的文件，内容如下：
<?php phpinfo(); ?> - 访问 phpinfo 页面： 在 浏览器 中访问 https://< 您的应用名称 >.azurewebsites.net/info.php。
- 检查 pdo_mysql 模块： 在打开的 phpinfo 页面中，搜索“pdo_mysql”或“MySQL”，如果看到相关的配置信息和模块已加载，则表示 pdo_mysql 扩展已成功启用。
重要提示： 验证完成后，请务必删除 info.php 文件，以避免泄露敏感的服务器信息。
注意事项与总结
- 路径准确性： 确保您修改的是 Web 服务器实际使用的 php.ini 文件。错误的路径修改将无效。
- PHP 版本： 替换命令中的 {version} 为您的 PHP 实际版本，例如 7.4、8.0 等。
- Azure App Service 的灵活性： Azure 环境有时会比较灵活，可能存在自定义启动脚本或 环境变量 覆盖 php.ini 配置的情况。如果上述方法无效，请检查您的 App Service 配置中是否有相关的“启动命令”或“应用程序设置”覆盖了 PHP 配置。
- Oryx Builder： 如果 Oryx Builder 在构建时仍然报告 pdo_mysql 缺失，这可能意味着构建环境的 PHP CLI 配置也需要调整。通常，Azure Web App 在运行时会加载您的自定义配置，但构建阶段可能不同。
- 持久化配置： 在某些情况下，直接修改 /etc 下的文件可能不会在应用服务重启后持久化。如果遇到此类问题，您可以考虑使用自定义启动脚本，在每次启动时通过脚本修改 php.ini，或者将自定义 php.ini 文件放置在应用程序目录中，并通过应用程序设置（如 PHP_INI_SCAN_DIR）指向它。
通过遵循上述步骤，您应该能够成功在 Azure Web App 中启用 pdo_mysql 扩展，从而解决 PHP 应用程序的数据库连接问题，确保您的 Laravel 或其他 PHP 应用能够顺畅运行。
