织梦CMS在Mac下如何链接数据库？-织梦建站-盈思创科技

核心思想

织梦CMS的数据库链接信息存储在网站根目录下的一个配置文件中,你的任务就是找到这个文件，然后用正确的数据库信息替换掉默认的或错误的信息。

（图片来源网络，侵删）

第一步：确认你的本地 Web 环境

在 macOS 上，最常用的本地 Web 环境是 MAMP 或 XAMPP，它们集成了 Apache/Nginx、MySQL 和 PHP，非常适合本地开发。

检查你是否已安装 MAMP/XAMPP：
- 打开“启动台”（Launchpad），搜索 MAMP 或 XAMPP。
- 如果找到了,说明你已经安装了，如果没有，请先从官网下载并安装它们。
  - MAMP 官方下载
  - XAMPP 官方下载
启动服务：
- 打开 MAMP/XAMPP，确保 Apache 和 MySQL 服务的开关都处于“开启”状态（通常是绿色）。

第二步：找到并修改数据库配置文件

这是最关键的一步,织梦CMS有两个主要的配置文件，你需要根据你的安装情况选择一个。

（图片来源网络，侵删）

全新安装织梦CMS（推荐）

如果你正在全新安装织梦CMS,安装程序会引导你填写数据库信息，你只需要在安装的最后一步，将生成的 data/common.inc.php 文件上传到你的服务器即可。

已安装，需要修改现有配置

如果你已经安装好了,但数据库信息变了，或者连接不上了，你需要手动修改配置文件。

找到网站根目录：
- 在 MAMP/XAMPP 中，你的网站通常存放在 htdocs (MAMP) 或 htdocs/www (XAMPP) 文件夹里。
- 你的织梦CMS项目可能位于：
```
/Applications/MAMP/htdocs/mydedecms/
```
- 你可以在访达（Finder）中，通过菜单栏的“前往” -> “前往文件夹...” 来打开这个路径。
定位配置文件：
- 进入你的织梦CMS网站根目录后,找到 data 文件夹。
- 在 data 文件夹中，找到名为 common.inc.php 的文件。
- 这个文件就是存储数据库链接信息的核心文件！
编辑配置文件：
- 强烈建议：在修改之前，先备份一份 common.inc.php 文件（复制一份，命名为 common.inc.php.bak）。
- 使用任何代码编辑器（如 VS Code、Sublime Text、TextMate，甚至是 macOS 自带的“文本编辑”App）打开 common.inc.php 文件。
修改数据库连接信息：
- 打开文件后,你会看到类似下面这样的代码块：
```
<?php
//数据库连接信息
$cfg_dbhost = 'localhost'; // 数据库主机
$cfg_dbname = 'dedecmsv57'; // 数据库名称
$cfg_dbuser = 'root'; // 数据库用户名
$cfg_dbpwd = 'root'; // 数据库密码
$cfg_dbprefix = 'dede_'; // 数据库前缀
$cfg_db_language = 'gbk'; // 数据库语言版本
// ... 其他配置
?>
```
- 你需要根据你的实际情况修改以下几项：
  - $cfg_dbhost: 数据库主机地址。在本地开发环境中，99% 的情况下都是 localhost。
  - $cfg_dbname: 你为织梦创建的数据库名称。my_dedecms。
  - $cfg_dbuser: 数据库用户名，在 MAMP/XAMPP 的默认配置中，通常是 root。
  - $cfg_dbpwd: 数据库密码。这是最容易出错的地方！
    - MAMP 用户：MAMP 的 MySQL 密码不是你的系统密码，你可以在 MAMP 主界面的 "Open WebStart page" 按钮旁边的 "MySQL" 下拉菜单中查看或设置密码，默认可能是 root 或 root（无密码），但强烈建议你设置一个强密码并记住它。
    - XAMPP 用户：XAMPP 的默认 MySQL 用户名是 root，密码通常是留空（即空字符串）。
  - $cfg_dbprefix: 数据库表前缀，如果你是全新安装，可以保持默认，如果你要将数据导入一个已有前缀的数据库，就需要修改成对应的前缀，wp_。

第三步：在 macOS 中创建和配置数据库

如果你还没有数据库,需要先创建一个。

打开 phpMyAdmin：
- 在 MAMP/XAMPP 的控制面板中，点击 "Open WebStart page" 按钮。
- 这会打开一个本地网页,其中会有一个指向 phpMyAdmin 的链接（通常在 "Tools" 或 "工具" 部分）。
- 点击进入 phpMyAdmin 管理界面。
创建新数据库：
- 在 phpMyAdmin 的主界面，顶部的输入框中输入你想创建的数据库名称（my_dedecms）。
- 在“排序规则”（Collation）下拉菜单中，选择 utf8_general_ci 或 utf8mb4_general_ci（推荐使用 utf8mb4 以支持更广泛的字符，包括 Emoji）。
- 点击“创建”按钮。
创建数据库用户（可选但推荐）：
- 在 phpMyAdmin 中，点击顶部的“用户账户”选项卡。
- 点击“添加用户账户”。
- 输入一个用户名（dede_user）。
- 在“主机名”部分，选择“本地”（Local）或手动输入 localhost。
- 输入并确认一个密码。
- 在“数据库-specific 权限”部分，从下拉列表中选择你刚刚创建的数据库（my_dedecms）。
- 勾选“全局”权限下的所有复选框，或者至少勾选“数据”、“结构”和“管理”下的所有核心权限。
- 点击“执行”按钮。
完成这一步后，你需要在 common.inc.php 文件中使用这个新创建的用户名和密码，而不是使用 root。

第四步：检查和测试

保存文件：保存你修改过的 common.inc.php 文件。

设置文件权限：为了安全，确保 common.inc.php 文件不是对所有人都可写的，在终端中，你可以进入网站目录，执行以下命令（如果需要）：

# 进入你的网站data目录
cd /Applications/MAMP/htdocs/mydedecms/data
# 设置文件所有者为你的用户，并移除其他用户的写权限
sudo chown $(whoami) common.inc.php
chmod 644 common.inc.php

访问网站：
- 在浏览器中访问你的织梦CMS网站地址（http://localhost/mydedecms/）。
- 如果一切配置正确,网站应该能正常加载，不会再提示数据库连接错误。

常见问题排查

错误提示：Can't connect to local MySQL server through socket '/var/mysql/mysql.sock'
- 原因：这是 macOS 上一个非常经典的问题，MAMP 自带的 MySQL 客户端和系统自带的 MySQL 客户端使用的 socket 文件路径不同，织梦（或 PHP）可能正在寻找系统路径下的 sock 文件，但 MAMP 的 MySQL 服务并没有在那里创建它。
- 解决方案：
  1. 在 MAMP 的设置中，找到 "File" -> "Edit Template" -> "my.cnf"。
  2. 在 [mysqld] 和 [client] 这两个部分下面，都添加一行：socket = /Applications/MAMP/tmp/mysql/mysql.sock (请确保这个路径与 MAMP 实际使用的路径一致)。
  3. 保存文件,然后重启 MAMP 的 MySQL 服务。
  4. 另一个简单的方法是：在你的 common.inc.php 文件中，在数据库连接信息后面，手动指定 socket 路径。
```
$cfg_dbhost = 'localhost:/Applications/MAMP/tmp/mysql/mysql.sock';
$cfg_dbname = 'my_dedecms';
// ... 其他信息
```
错误提示：Access denied for user 'root'@'localhost' (using password: YES)
- 原因：密码错误。
- 解决方案：请仔细检查你在 common.inc.php 中填写的 $cfg_dbpwd 是否与 MAMP/XAMPP 中设置的 MySQL 密码完全一致，注意大小写和空格。

按照以上步骤,你应该就能成功在 macOS 上为织梦CMS链接数据库了，祝你顺利！

织梦CMS在Mac下如何链接数据库？