215 lines
4.4 KiB
Markdown
215 lines
4.4 KiB
Markdown
# 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/`
|