部署到我的服务器

PHP 8.2 + MySQL 5.7,零外部 CDN、零构建工具、零 Composer 依赖 —— 上传文件、导入 SQL、改一处配置即可运行。

PHP 8.2MySQL 5.7PyTorch U-NetThree.js 3DNginx / Apacheutf8mb4

当前站点自检

PHP 版本8.2.33
pdo_mysql 扩展已启用 ✓
mbstring 扩展已启用 ✓
数据库连接正常 ✓
神经网络服务正常 ✓
几何引擎可加载 ✓
识别引擎模式geometry+neural
站点版本v1.0.0
1

确认运行环境

组件要求说明与检查命令
PHP8.2(≥8.1 亦可)需启用 pdo_mysql、mbstring;php -m | grep -E 'pdo_mysql|mbstring'
MySQL5.7(5.6 / 8.0 兼容)建库排序规则用 utf8mb4_unicode_ci,不要用 MySQL 8 专属的 utf8mb4_0900_ai_ci
Web 服务器Nginx 1.20+ / Apache 2.4+PHP-FPM 方式最佳;Apache 需开启 mod_rewrite
操作系统Linux(推荐)/ Windows宝塔、Ubuntu、CentOS、Debian 均可;Windows 可用 IIS / Apache
外部依赖无不引 CDN、不需 Composer、不需 Node 构建,断网环境也能完整显示
2

四步通用流程

01

上传源码

把整个 zhj-home-ai/ 目录上传到网站根目录(或解压后把目录内文件放到根目录)。

02

导入数据库

在 MySQL 中执行 sql/init.sql,自动建库、建表并写入演示数据。

03

修改配置

编辑 inc/config.php 的 db 段:host / name / user / pass。

04

配置站点

运行目录设为 public 不存在时保持根目录;套用提供的 Nginx / Apache 规则,重启服务。

3

选一种部署方式

宝塔面板(国内服务器最省心)

  1. 装环境:软件商店安装 Nginx 1.24、MySQL 5.7、PHP 8.2;在 PHP-8.2「安装扩展」中确认 pdo_mysql、mbstring 已装,「禁用函数」里不要禁用 putenv 之外的必要函数。
  2. 加站点:网站 → 添加站点,域名填 IP 或已解析域名,数据库选 MySQL,记下自动生成的库名 / 账号 / 密码,PHP 版本选 8.2。
  3. 传文件:文件管理进入站点根目录(如 /www/wwwroot/你的域名/),上传项目压缩包并解压,确保 index.php 位于根目录。
  4. 导 SQL:数据库 → 对应库 →「导入」→ 上传 sql/init.sql;或在 phpMyAdmin 中执行。若第 2 步已让宝塔建了同名库,脚本里的 CREATE DATABASE IF NOT EXISTS 不会冲突。注意脚本含 DROP TABLE IF EXISTS,有历史数据后请勿重复导入,先备份。
  5. 改配置:编辑 inc/config.php,把 db.name / user / pass 换成宝塔给的值,host 保持 127.0.0.1。
  6. 站点设置:站点 → 设置 →「配置文件」套用 nginx.conf.example 中的 location 规则(重点是禁止访问 inc/ sql/ docker/);「伪静态」留空即可,本站使用实体 .php 文件,无需重写。
  7. 权限:根目录所有者设为 www:www,目录 755、文件 644;inc/config.php 可设 640。
  8. 验收:浏览器访问 http://域名/,页面顶部黄色提示条消失即表示数据库连通;再进「在线演示」提交一条,去「识别记录」查看。

Docker Compose 一键起服务(PHP 8.2-FPM + MySQL 5.7 + Nginx)

# 在项目根目录执行
cd docker
docker compose up -d --build

# 查看状态与日志
docker compose ps
docker compose logs -f php

# 访问 http://服务器IP:8080
# 停止:docker compose down(加 -v 会连同数据库数据一起删除,慎用)
  • docker/Dockerfile 基于 php:8.2-fpm 并安装 pdo_mysql。
  • sql/init.sql 挂载到 MySQL 容器的初始化目录,首次启动自动建库建表。
  • inc/config.php 中 db.host 需改为 mysql(Compose 服务名),账号密码与 docker-compose.yml 保持一致。
  • 数据落在命名卷 mysql_data,容器重建不丢数据;上线前请修改默认密码。

手动 LNMP / LAMP(Ubuntu / Debian 示例)

# 1. 安装 PHP 8.2 与扩展(Ubuntu 22.04 需先加 ondrej/php 源)
sudo apt update
sudo apt install -y nginx mysql-server php8.2-fpm php8.2-mysql php8.2-mbstring

# 2. 部署源码
sudo mkdir -p /var/www/zhj-home-ai
sudo cp -r ./zhj-home-ai/. /var/www/zhj-home-ai/
sudo chown -R www-data:www-data /var/www/zhj-home-ai
sudo find /var/www/zhj-home-ai -type d -exec chmod 755 {} \;
sudo find /var/www/zhj-home-ai -type f -exec chmod 644 {} \;

# 3. 初始化数据库
sudo mysql -u root -p < /var/www/zhj-home-ai/sql/init.sql

# 4. 建账号并授权(密码请自行替换)
sudo mysql -u root -p -e "CREATE USER 'zhj_home'@'localhost' IDENTIFIED BY '强密码'; \
GRANT SELECT,INSERT,UPDATE,DELETE ON zhj_home_ai.* TO 'zhj_home'@'localhost'; FLUSH PRIVILEGES;"

# 5. 站点配置
sudo cp /var/www/zhj-home-ai/nginx.conf.example /etc/nginx/sites-available/zhj-home-ai
sudo ln -s /etc/nginx/sites-available/zhj-home-ai /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

# Apache 用户:启用 mod_rewrite,把根目录 .htaccess 保持原样即可,无需 Nginx 配置

记得按实际路径修改 nginx.conf.example 里的 root 与 fastcgi_pass(Ubuntu 通常为 unix:/run/php/php8.2-fpm.sock)。

本地快速预览(开发 / 汇报前检查)

# 需本机已安装 PHP 8.2 并启用 pdo_mysql、mbstring
cd zhj-home-ai
php -S 127.0.0.1:8000

# 浏览器打开 http://127.0.0.1:8000/
# 即使没有 MySQL,技术解析页面也能完整显示(静态展示模式)

PHP 内置服务器仅用于本机预览,性能与安全性不足以对外提供服务,正式上线请用 Nginx/Apache + PHP-FPM。

4

配置项速查

键当前值说明
db.host127.0.0.1数据库地址;Docker 部署填服务名 mysql
db.port3306MySQL 端口,默认 3306
db.name / user / passzij_pudn_cn / zij_pudn_cn库名、账号、密码;密码请勿使用示例值上线
db.charsetutf8mb4固定 utf8mb4,勿改
enginegeometry+neuralmock=流程演示;http=转发自有算法服务
engine_api / engine_key预留接入真实识别服务时填写,见 README 第 10.3 节
debugfalse生产环境保持 false,错误只写 error_log
page_size10识别记录每页条数
5

神经网络识别服务(图片识别必装)

DXF 几何识别不需要此服务;上传户型图片走 U-Net 时才需要。服务默认监听 9000 端口,PHP 通过 engine_api 调用。

# 1) 环境:Python 3.11(3.10+ 亦可)
cd ai
python -m venv venv
source venv/bin/activate          # Windows: venv\Scripts\activate

# 2) 安装 CPU 版 PyTorch 与应用依赖
pip install torch --index-url https://download.pytorch.org/whl/cpu
pip install -r requirements.txt

# 3) 启动推理服务(权重已随项目交付于 ai/weights/)
python serve.py                    # 监听 0.0.0.0:9000

# 4) 健康检查
curl http://127.0.0.1:9000/health

# 5) 如需重新训练(数据由程序合成,无需真实户型图)
python generate_dataset.py --out data --train 400 --val 100 --size 96
python train.py --data data --weights weights --epochs 14 --batch 16 --base 8 --lr 0.003

# 6) 或以 Docker 方式运行
docker build -t zhj-neural -f ai/Dockerfile ai/
docker run -d -p 9000:9000 --name zhj-neural zhj-neural

生产环境用 systemd 托管:创建 /etc/systemd/system/zhj-neural.service,ExecStart 指向 venv 中的 python serve.py,WorkingDirectory 设为 ai/,然后 systemctl enable --now zhj-neural。Nginx 不需要暴露 9000 端口,仅 PHP 本机访问即可。

6

验收与排错

上线验收清单

  • 首页完整显示,样式与 SVG 插画正常(无外链资源加载失败)
  • 页面顶部没有黄色「数据库未连接」提示条
  • 「在线演示」提交后能出现 7 个阶段逐条打勾
  • 「识别记录」能看到刚提交的任务,中文不乱码
  • 直接访问 /inc/config.php 返回 403
  • 直接访问 /sql/init.sql 返回 403 / 404
  • 手机端导航可展开、表格可横向滚动

常见问题

页面白屏 / 500

多为 PHP 版本低于 8.1 或缺少 pdo_mysql;查看 error_log,把 debug 临时设为 true。

顶部一直提示数据库未连接

核对 config.php 四项;宝塔创建的账号可能只允许 localhost;Docker 需把 host 改成 mysql。

中文乱码 / 表情报错

确认库、表、连接均为 utf8mb4;不要在 MySQL 5.7 上使用 utf8mb4_0900_ai_ci。

提交演示报 503 / 500

503=未连库;500=表未建或字段不符,重新完整导入 sql/init.sql。

样式全丢

检查 assets/css/style.css 是否上传、Nginx 是否把静态资源交给 PHP 处理、文件权限是否 644。

访问 inc/ 能下载 PHP 源码

Nginx 未套用 deny 规则或 Apache 未启用 .htaccess(需 AllowOverride All)。

完整手册

更详尽的目录说明、安全加固、二次开发、接入真实识别引擎的接口规范,请查阅项目根目录的 README.md。本页为网页版速查,方便部署时直接在浏览器里对照操作。