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`，搜索以下行并删除前面的分号 `;`：

```ini
;extension=pdo_mysql
;extension=mysqli
```

改为：

```ini
extension=pdo_mysql
extension=mysqli
```

3. 保存文件并关闭

4. 验证扩展是否启用：
```bash
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/

### 第三步：安装项目依赖

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

```bash
composer install
```

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

### 第四步：配置数据库

1. 创建数据库：
```sql
CREATE DATABASE kingcharm DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
```

2. 导入数据库文件：
```bash
mysql -u root -p kingcharm < kingcharm.sql
```

3. 修改数据库配置文件 `application/database.php`：
```php
return [
    'type'            => 'mysql',
    'hostname'        => '127.0.0.1',
    'database'        => 'kingcharm',
    'username'        => 'root',
    'password'        => '你的密码',
    'hostport'        => '3306',
    'charset'         => 'utf8mb4',
    // ...其他配置
];
```

### 第五步：配置目录权限

确保以下目录可写：
- `runtime/` (运行时缓存)
- `public/uploads/` (上传文件)

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

### 第六步：启动项目

#### 方式1：使用PHP内置服务器（快速测试）
```bash
cd public
php -S localhost:8888
```

访问：http://localhost:8888

#### 方式2：使用Apache/Nginx
将项目部署到Web服务器，确保：
- 网站根目录指向 `public` 目录
- 启用 `.htaccess` 重写规则（Apache需要开启 `mod_rewrite`）

---

## 常见问题排查

### 问题1：composer install 很慢
**解决方案**：切换到国内镜像
```bash
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错误日志

---

## 验证环境

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

```bash
# 检查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/`