如何在MacOS配置PHP支持MySQL Mac系统PHP连接数据库设置方法

絕刀狂花

发布时间：2025-07-21 17:37:01

470人浏览过

来源于php中文网

原创

要让php在macos上连接mysql，核心是安装mysql扩展并配置连接信息。1.使用homebrew安装或更新php和mysql，确保php版本较新且路径正确；2.编辑php.ini文件，启用mysqli和pdo_mysql扩展；3.配置mysql服务开机自启并启动；4.重启web服务器使配置生效；5.通过phpinfo()或php -m验证扩展是否加载；6.使用mysqli或推荐的pdo方式编写连接代码，并根据常见错误排查连接问题。整个流程需注意php与mysql服务状态、扩展加载、用户权限及socket路径一致性。

如何在MacOS配置PHP支持MySQL Mac系统PHP连接数据库设置方法

在macOS上让PHP能和MySQL好好沟通，核心思路其实就两点：一是确保PHP本身装了能“说”MySQL话的“翻译官”（也就是对应的扩展），二是让PHP知道你的MySQL服务器在哪儿，以及怎么进去。这听起来可能有点抽象，但实际操作起来，无非就是修改几个配置文件，或者运行几行命令的事情，没想象中那么复杂，但也确实有些小坑需要留意。

解决方案

要在macOS上配置PHP支持MySQL，我们通常会从以下几个方面入手，考虑到macOS自带的PHP版本可能比较老旧，或者缺少某些扩展，用Homebrew来管理PHP和MySQL是目前最省心也最推荐的方式。

首先，确保你的系统已经安装了Homebrew。如果还没装，打开终端，粘贴官网那段安装命令跑一下就行。

立即学习“PHP免费学习笔记（深入）”；

接着，我们用Homebrew来安装或管理PHP和MySQL。

安装或更新MySQL: 如果你还没装MySQL，或者想用最新版，终端里敲： brew install mysql 安装完成后，它会提示你如何启动MySQL服务，通常是： brew services start mysql 或者手动启动： mysql.server start 建议你配置MySQL开机自启，这样省事： brew services enable mysql
安装或更新PHP: macOS自带的PHP版本通常比较旧，而且可能没有预装mysqli或pdo_mysql扩展。用Homebrew安装特定版本或最新版PHP是更好的选择。例如，安装PHP 8.x： brew install php 如果你之前用Homebrew装过PHP，可以更新： brew upgrade php 安装后，Homebrew会自动处理PHP的路径问题，让你的系统默认使用Homebrew安装的PHP。你可以通过 php -v 确认当前使用的PHP版本。
配置PHP以启用MySQL扩展 (php.ini): 这是关键一步。PHP需要加载mysqli和pdo_mysql这两个扩展才能连接MySQL。
- 找到 php.ini 文件: Homebrew安装的PHP，其php.ini通常在 /usr/local/etc/php/8.x/php.ini （这里的8.x是你安装的PHP版本）。如果你不确定，可以运行 php --ini 命令，它会告诉你php.ini的路径。通常，Homebrew安装的PHP会有一个php.ini.default或php.ini-development文件，你需要复制一份并重命名为php.ini： cp /usr/local/etc/php/8.x/php.ini-development /usr/local/etc/php/8.x/php.ini
- 编辑 php.ini: 用你喜欢的文本编辑器打开php.ini文件（例如 nano /usr/local/etc/php/8.x/php.ini）。在文件里搜索 extension=，你会找到很多以分号 ; 开头的行。分号表示注释掉了，我们需要取消注释。找到并取消以下两行的注释（删除前面的分号）： extension="mysqli"extension="pdo_mysql" 确保这些扩展指向的.so文件存在。Homebrew通常会把它们放在正确的位置。
- 重启PHP服务: 如果你在使用Nginx或Apache作为Web服务器，需要重启它们的服务，以便PHP加载新的php.ini配置。例如，对于Nginx：brew services restart nginx 对于Apache（macOS自带的）：sudo apachectl restart 如果你使用的是PHP内置的Web服务器 (php -S localhost:8000)，直接重启你的PHP进程即可。

如何验证PHP的MySQL扩展是否已启用？

嗯，配置完一堆东西，最让人忐忑的就是“到底有没有生效”这个问题。我个人习惯用两种方式来快速验证，通常第一种就够了，但第二种在某些特定场景下能提供更多细节。

方法一：创建 phpinfo() 文件 这是最直观也最常用的方法。

在你Web服务器的根目录（比如Nginx的html目录，或者Apache的htdocs目录）下，创建一个名为 info.php 的文件。
文件内容就一行：
```
<?php phpinfo(); ?>
```
保存文件后，在浏览器中访问这个文件，比如 http://localhost/info.php。
在打开的页面中，搜索 "MySQLi" 或 "PDO_MySQL"。
- 如果你能看到一个名为 "mysqli" 的区块，里面显示 "Client API library version" 和 "Driver version"，说明mysqli扩展已经加载成功了。
- 同样，如果能看到 "pdo_mysql" 的区块，显示 "Client API version" 等信息，说明pdo_mysql也正常工作。如果找不到这些区块，或者相关信息是空的，那就说明扩展没加载上，需要回头检查php.ini的路径、内容以及Web服务器是否重启。

方法二：使用命令行检查 这个方法不用依赖Web服务器，纯粹检查PHP CLI（命令行接口）的扩展加载情况。在终端里输入： php -m 这个命令会列出所有当前PHP CLI加载的模块。在输出的列表中，你应该能看到 mysqli 和 pdo_mysql。如果这里能看到，而phpinfo()看不到，那很可能是你的Web服务器用的PHP版本或php.ini路径和CLI的不一致。这是个常见的小坑，尤其是在macOS上，系统自带PHP和Homebrew安装的PHP容易混淆。检查一下Web服务器的配置，确保它指向的是你Homebrew安装的PHP。

PHP连接MySQL的代码示例和常见错误排查

好了，扩展确认加载了，接下来就是写代码连接数据库了。这里我会提供mysqli和PDO两种方式的简单示例，并顺便聊聊一些我遇到过的，或者别人经常遇到的连接问题。

使用 mysqli 连接 MySQL 示例：

mysqli是PHP官方推荐的MySQL连接方式之一，支持面向对象和面向过程两种风格。这里用面向对象的风格，因为它更现代也更易读。

<?php
$servername = "localhost"; // MySQL服务器地址，通常是localhost
$username = "your_mysql_username"; // 你的MySQL用户名
$password = "your_mysql_password"; // 你的MySQL密码
$dbname = "your_database_name"; // 你要连接的数据库名

// 创建连接
$conn = new mysqli($servername, $username, $password, $dbname);

// 检查连接是否成功
if ($conn->connect_error) {
    die("连接失败: " . $conn->connect_error);
}
echo "数据库连接成功！";

// 接下来你就可以执行SQL查询了
// 例如：
// $sql = "SELECT id, name FROM users";
// $result = $conn->query($sql);

// 关闭连接
$conn->close();
?>

记得把 your_mysql_username, your_mysql_password, your_database_name 替换成你自己的实际信息。

云从科技AI开放平台

云从AI开放平台

下载

常见错误排查：

Connection refused 或 Can't connect to local MySQL server through socket:
- 原因: MySQL服务没有运行，或者socket文件路径不对。
- 解决方案:
  - 确认MySQL服务正在运行：brew services list 看看mysql是不是started。如果不是，brew services start mysql。
  - 检查php.ini中mysqli.default_socket和pdo_mysql.default_socket的配置，确保它指向MySQL的socket文件（通常在/tmp/mysql.sock或/usr/local/var/mysql/mysql.sock）。有时候PHP会找不到这个文件，导致连接失败。
Access denied for user 'your_username'@'localhost':
- 原因: 数据库用户名或密码错误，或者该用户没有权限从localhost连接。
- 解决方案:
  - 仔细核对你在PHP代码中填写的用户名和密码。
  - 登录MySQL（mysql -u root -p），检查用户权限。例如，为你的用户授予权限： GRANT ALL PRIVILEGES ON your_database_name.* TO 'your_username'@'localhost' IDENTIFIED BY 'your_password';FLUSH PRIVILEGES; （注意：ALL PRIVILEGES权限过大，生产环境不推荐，这里仅为测试方便）
  - 确保用户可以从localhost连接，而不是只允许从127.0.0.1或特定IP连接。
Undefined function mysqli_connect() 或 Class 'mysqli' not found:
- 原因: mysqli扩展没有被PHP加载。
- 解决方案: 回到上一节，重新检查php.ini中extension="mysqli"是否已取消注释，以及Web服务器是否已重启。确认phpinfo()中能看到mysqli模块。

除了MySQLi，PHP连接MySQL还有哪些推荐方式？

除了mysqli，PHP连接MySQL的另一种主流且更推荐的方式是使用PDO (PHP Data Objects)。PDO提供了一个轻量级、一致的接口来访问多种数据库，而不仅仅是MySQL。这意味着如果你未来需要切换到PostgreSQL或SQLite等其他数据库，你的大部分数据库操作代码都不需要大改，只需修改连接字符串即可。

使用 PDO 连接 MySQL 示例：

PDO的优势在于其统一的API和对预处理语句的原生支持，这对于防止SQL注入攻击非常重要。

<?php
$dsn = "mysql:host=localhost;dbname=your_database_name;charset=utf8mb4"; // 数据源名称
$username = "your_mysql_username";
$password = "your_mysql_password";

try {
    $pdo = new PDO($dsn, $username, $password);
    // 设置PDO错误模式为异常，这样可以捕获并处理数据库操作中的错误
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    $pdo->setAttribute(PDO::ATTR_EMULATE_PREPARES, false); // 禁用模拟预处理，使用真正的预处理

    echo "数据库连接成功 (PDO)！";

    // 接下来你可以执行SQL查询，推荐使用预处理语句
    // 示例：插入数据
    // $stmt = $pdo->prepare("INSERT INTO users (name, email) VALUES (:name, :email)");
    // $stmt->bindParam(':name', $name);
    // $stmt->bindParam(':email', $email);
    // $name = "张三";
    // $email = "zhangsan@example.com";
    // $stmt->execute();

} catch (PDOException $e) {
    die("连接失败 (PDO): " . $e->getMessage());
}

// PDO连接在脚本执行结束时会自动关闭，但你也可以显式置空
$pdo = null;
?>

同样，别忘了替换占位符。

为什么推荐PDO？