oms-back/环境配置指南.md

ThinkPHP 5.0 项目环境配置指南

当前环境检测结果

✓ 已安装

• PHP: 7.3.16 (满足要求 >= 5.4.0)
• Composer: 2.8.9
• PHP路径: D:\ProgramFiles\php\php-7.3.16-Win32-VC15-x64\

✓ 已启用的PHP扩展

• bcmath
• curl
• gd
• mbstring
• openssl
• zip
• PDO
• mysqlnd
• fileinfo
• json
• xml

⚠️ 缺少的关键扩展

• pdo_mysql (必需 - 用于MySQL数据库连接)
• mysqli (建议 - MySQL改进扩展)

---

详细安装步骤

第一步：启用MySQL扩展

1. 找到PHP配置文件 php.ini

   • 位置：D:\ProgramFiles\php\php-7.3.16-Win32-VC15-x64\php.ini
   • 如果没有 php.ini，复制 php.ini-development 并重命名为 php.ini

2. 用文本编辑器打开 php.ini，搜索以下行并删除前面的分号 ;：

;extension=pdo_mysql
;extension=mysqli

改为：

extension=pdo_mysql
extension=mysqli

3. 保存文件并关闭

4. 验证扩展是否启用：

php -m | findstr mysql

应该看到：

mysqli
mysqlnd
pdo_mysql

第二步：安装MySQL数据库

如果还没有安装MySQL，选择以下方式之一：

方式1：MySQL官方版本

1. 下载：https://dev.mysql.com/downloads/mysql/
2. 选择 Windows 版本
3. 安装并记住root密码

方式2：phpStudy/XAMPP（推荐新手）

• phpStudy: https://www.xp.cn/
• XAMPP: https://www.apachefriends.org/

第三步：安装项目依赖

在项目根目录打开命令行，执行：

composer install

这将安装以下依赖包：

• topthink/framework (ThinkPHP核心)
• topthink/think-captcha (验证码)
• topthink/think-image (图像处理)
• topthink/think-queue (队列)
• phpoffice/phpexcel (Excel处理)
• aliyuncs/oss-sdk-php (阿里云OSS)
• 等其他依赖...

第四步：配置数据库

1. 创建数据库：

CREATE DATABASE kingcharm DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

2. 导入数据库文件：

mysql -u root -p kingcharm < kingcharm.sql

3. 修改数据库配置文件 application/database.php：

return [
    'type'            => 'mysql',
    'hostname'        => '127.0.0.1',
    'database'        => 'kingcharm',
    'username'        => 'root',
    'password'        => '你的密码',
    'hostport'        => '3306',
    'charset'         => 'utf8mb4',
    // ...其他配置
];

第五步：配置目录权限

确保以下目录可写：

• runtime/ (运行时缓存)
• public/uploads/ (上传文件)

Windows下通常不需要特别设置，但如果遇到权限问题，右键文件夹 → 属性 → 安全 → 编辑权限

第六步：启动项目

方式1：使用PHP内置服务器（快速测试）

cd public
php -S localhost:8888

访问：http://localhost:8888

方式2：使用Apache/Nginx

将项目部署到Web服务器，确保：

• 网站根目录指向 public 目录
• 启用 .htaccess 重写规则（Apache需要开启 mod_rewrite）

---

常见问题排查

问题1：composer install 很慢

解决方案：切换到国内镜像

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

问题2：提示找不到pdo_mysql

解决方案：

1. 检查 php.ini 中的 extension_dir 配置是否正确
2. 确认 ext 目录下存在 php_pdo_mysql.dll 文件
3. 重启命令行或Web服务器

问题3：数据库连接失败

检查清单：

• MySQL服务是否启动
• 数据库名、用户名、密码是否正确
• 防火墙是否阻止3306端口
• pdo_mysql 扩展是否已启用

问题4：页面显示空白

解决方案：

1. 检查 runtime/log 目录下的错误日志
2. 开启调试模式（application/config.php 设置 app_debug => true）
3. 检查PHP错误日志

---

验证环境

运行以下命令验证环境是否配置正确：

# 检查PHP版本
php -v

# 检查已安装的扩展
php -m

# 检查Composer
composer --version

# 检查MySQL连接
mysql -u root -p -e "SELECT VERSION();"

---

项目信息

• 框架: ThinkPHP 5.0
• PHP要求: >= 5.4.0
• 数据库: MySQL
• Web服务器: Apache/Nginx（支持URL重写）

---

下一步

环境配置完成后：

1. 访问项目首页测试
2. 检查后台管理功能
3. 查看项目文档了解业务逻辑
4. 开始开发或调试

如有问题，请查看：

• ThinkPHP官方文档：http://www.kancloud.cn/manual/thinkphp5
• 项目日志：runtime/log/