mirror of
https://github.com/acepanel/acepanel.github.io.git
synced 2026-02-05 03:43:44 +08:00
124 lines
3.1 KiB
Markdown
124 lines
3.1 KiB
Markdown
# PHP 网站
|
||
|
||
PHP 网站用于运行 PHP 程序，如 WordPress、Laravel、ThinkPHP 等。
|
||
|
||
## 前置要求
|
||
|
||
创建 PHP 网站前，需要先安装：
|
||
|
||
1. **Web 服务器**：Nginx、OpenResty 或 Apache
|
||
2. **PHP 运行环境**：在 **应用** > **运行环境** 中安装所需的 PHP 版本
|
||
|
||
## 创建 PHP 网站
|
||
|
||
1. 进入 **网站** 页面
|
||
2. 点击 **PHP** 标签
|
||
3. 点击 **创建网站**
|
||
|
||
### 配置项
|
||
|
||
- **名称**：网站标识，如 `wordpress`
|
||
- **域名**：绑定的域名，如 `blog.example.com`
|
||
- **端口**：监听端口，默认 80
|
||
- **PHP 版本**：选择已安装的 PHP 版本
|
||
- **网站目录**：网站文件存放路径
|
||
- **备注**：可选备注
|
||
|
||
## 编辑 PHP 网站
|
||
|
||
点击网站列表中的 **编辑** 按钮进入编辑页面。
|
||
|
||
### 域名和监听
|
||
|
||
配置网站的域名和监听端口。
|
||
|
||
|
||
|
||
### 基本设置
|
||
|
||
配置网站目录、PHP 版本等基本信息。
|
||
|
||
|
||
|
||
- **网站目录**：网站文件存放的绝对路径
|
||
- **运行目录**：Laravel 等框架需要设置运行目录
|
||
- **默认文档**：默认首页文件，如 `index.php`、`index.html`
|
||
- **PHP 版本**：选择已安装的 PHP 版本
|
||
- **防跨站攻击**：启用后限制 PHP 只能访问网站目录内的文件
|
||
|
||
### 伪静态配置
|
||
|
||
伪静态用于 URL 重写，支持常见 PHP 程序的预设规则。
|
||
|
||
|
||
|
||
点击预设下拉框可以选择常见程序的伪静态规则：
|
||
|
||
|
||
|
||
支持的预设包括：WordPress、Laravel、ThinkPHP、Discuz、Drupal、ECShop 等常见 PHP 程序。
|
||
|
||
## 网站目录结构
|
||
|
||
创建网站后，默认目录结构：
|
||
|
||
```
|
||
/opt/ace/sites/网站名称/public
|
||
├── index.php # 入口文件
|
||
├── .user.ini # PHP 配置
|
||
└── ...
|
||
```
|
||
|
||
## PHP 版本切换
|
||
|
||
在网站编辑页面的 **基本设置** 中可以切换 PHP 版本：
|
||
|
||
1. 进入网站编辑页面
|
||
2. 点击 **基本设置** 标签
|
||
3. 在 **PHP 版本** 下拉框中选择新版本
|
||
4. 点击 **保存**
|
||
|
||
::: warning 注意
|
||
切换 PHP 版本可能导致程序不兼容，请先在测试环境验证。
|
||
:::
|
||
|
||
## PHP 配置
|
||
|
||
### php.ini 配置
|
||
|
||
在 **应用** > **原生应用** > **PHP** 管理页面可以修改 php.ini 配置。
|
||
|
||
常用配置项：
|
||
|
||
```ini
|
||
upload_max_filesize = 50M # 最大上传文件大小
|
||
post_max_size = 50M # POST 数据最大大小
|
||
max_execution_time = 300 # 最大执行时间
|
||
memory_limit = 256M # 内存限制
|
||
```
|
||
|
||
### 禁用函数
|
||
|
||
PHP 默认禁用了一些危险函数，如 `exec`、`system`、`passthru` 等。如需启用，请在 php.ini 中修改 `disable_functions` 配置。
|
||
|
||
::: danger 警告
|
||
启用危险函数可能带来安全风险，请谨慎操作。
|
||
:::
|
||
|
||
## 常见问题
|
||
|
||
### 502 Bad Gateway
|
||
|
||
- 检查 PHP-FPM 是否正常运行
|
||
- 检查 PHP 版本是否正确配置
|
||
|
||
### 文件上传失败
|
||
|
||
- 检查 `upload_max_filesize` 和 `post_max_size` 配置
|
||
- 检查目录权限
|
||
|
||
### 页面空白
|
||
|
||
- 开启 PHP 错误显示
|
||
- 查看 PHP 错误日志
|