Skip to content

Commit 00437e0

Browse files
docs: add php runtime offline usage (#60)
1 parent 5654a96 commit 00437e0

5 files changed

Lines changed: 66 additions & 3 deletions

File tree

184 KB
Loading
179 KB
Loading
180 KB
Loading

docs/installation/package_installation.md

Lines changed: 65 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -225,19 +225,81 @@
225225

226226
完成以上步骤后,即可让离线服务器加载最新的应用商店内容。
227227

228-
## 8. 应用安装方式说明
228+
## 8. PHP 离线版
229+
230+
!!! note "准备环境"
231+
- 1Panel V2 离线服务器
232+
- 1Panel V2 外网服务器
233+
234+
> 核心操作是:将外网服务器中编译好的 PHP 镜像导入到离线服务器上。
235+
236+
### 8.1 外网 1Panel
237+
238+
!!! note ""
239+
在 1Panel 外网环境创建 PHP 运行环境,并安装相应扩展(需要记录 **镜像名称** 和端口)
240+
241+
![offline_php_01](../../img/offline/offline_php_01.png)
242+
243+
!!! note ""
244+
使用上一步的 **镜像名称** 打包 PHP 镜像,在 `/opt/1panel/runtime/php/<PHP 运行环境名称>` 下执行:
245+
246+
```bash
247+
docker save -o php-8.4.6.tar 1panel-php-fpm:8.4.6
248+
```
249+
250+
!!! note ""
251+
压缩运行环境目录,在 `/opt/1panel/runtime/php/` 目录下执行:
252+
253+
```bash
254+
tar -czvf php846.tar.gz <PHP 运行环境名称>
255+
```
256+
257+
### 8.2 离线 1Panel
258+
259+
!!! note ""
260+
拷贝压缩文件到 `/opt` 或其他目录并解压:
261+
```bash
262+
tar -xzvf php846.tar.gz
263+
```
264+
265+
!!! note ""
266+
进入解压后的目录,加载镜像并启动 PHP 运行环境:
267+
```bash
268+
docker load -i php-8.4.6.tar
269+
docker compose up
270+
```
271+
272+
使用 cat .env 查看两个参数:
273+
274+
- PANEL_APP_PORT_HTTP (PHP 运行环境端口)
275+
- PANEL_WEBSITE_DIR (网站目录)
276+
277+
> 注意:PANEL_WEBSITE_DIR 需要和 OpenResty 安装时的网站目录保持一致,如不一致请修改 .env 文件。
278+
279+
!!! note ""
280+
创建本地 PHP 运行环境
281+
282+
![offline_php_02](../../img/offline/offline_php_02.png)
283+
284+
!!! note ""
285+
创建 PHP 网站
286+
> 注意:端口填写你启动的 PHP 运行环境端口。
287+
288+
![offline_php_03](../../img/offline/offline_php_03.png)
289+
290+
## 9. 应用安装方式说明
229291

230292
!!! note ""
231293
在离线版中,安装应用与通过「本地应用」安装应用存在一定差异,主要体现在以下几点:
232294

233-
### 8.1 对比结果
295+
### 9.1 对比结果
234296

235297
| 方式 | 应用来源 | 是否包含所有应用 | 是否自动集成功能菜单 |
236298
|------|----------|------------------|----------------------|
237299
| 离线版安装应用 | 离线包中已预置 | ✅ 是 | ✅ 是(如网站、数据库) |
238300
| 本地应用方式安装 | 用户手动上传 | ❌ 否 | ❌ 否 |
239301

240-
### 8.2 推荐使用场景
302+
### 9.2 推荐使用场景
241303

242304
!!! note ""
243305
- **离线版安装应用**:适合无网络环境下快速部署,所有功能完整,体验最佳。

docs/user_manual/websites/php.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@
2424

2525
- 可以从其他 1Panel 服务器拷贝 /opt/1panel/runtime/php/[php_name] 目录和镜像,并上传到离线版 1Panel 服务器,并使用 docker compose up 命令启动,记住映射的端口
2626
- 创建运行环境网站,选择刚刚创建的 PHP 运行环境,修改端口为刚才启动的端口
27+
- 详细操作步骤可参考:[PHP 离线版使用文档](../../installation/package_installation.md/#8-php)
2728

2829
![img.png](../../img/websites/runtime_local_website.png)
2930
{: .browser-mockup}

0 commit comments

Comments
 (0)