PHP 8.2 + MySQL 5.7,零外部 CDN、零构建工具、零 Composer 依赖 —— 上传文件、导入 SQL、改一处配置即可运行。
| 组件 | 要求 | 说明与检查命令 |
|---|---|---|
| PHP | 8.2(≥8.1 亦可) | 需启用 pdo_mysql、mbstring;php -m | grep -E 'pdo_mysql|mbstring' |
| MySQL | 5.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 构建,断网环境也能完整显示 |
把整个 zhj-home-ai/ 目录上传到网站根目录(或解压后把目录内文件放到根目录)。
在 MySQL 中执行 sql/init.sql,自动建库、建表并写入演示数据。
编辑 inc/config.php 的 db 段:host / name / user / pass。
运行目录设为 public 不存在时保持根目录;套用提供的 Nginx / Apache 规则,重启服务。
Nginx 1.24、MySQL 5.7、PHP 8.2;在 PHP-8.2「安装扩展」中确认 pdo_mysql、mbstring 已装,「禁用函数」里不要禁用 putenv 之外的必要函数。MySQL,记下自动生成的库名 / 账号 / 密码,PHP 版本选 8.2。/www/wwwroot/你的域名/),上传项目压缩包并解压,确保 index.php 位于根目录。sql/init.sql;或在 phpMyAdmin 中执行。若第 2 步已让宝塔建了同名库,脚本里的 CREATE DATABASE IF NOT EXISTS 不会冲突。注意脚本含 DROP TABLE IF EXISTS,有历史数据后请勿重复导入,先备份。inc/config.php,把 db.name / user / pass 换成宝塔给的值,host 保持 127.0.0.1。nginx.conf.example 中的 location 规则(重点是禁止访问 inc/ sql/ docker/);「伪静态」留空即可,本站使用实体 .php 文件,无需重写。www:www,目录 755、文件 644;inc/config.php 可设 640。http://域名/,页面顶部黄色提示条消失即表示数据库连通;再进「在线演示」提交一条,去「识别记录」查看。# 在项目根目录执行
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,容器重建不丢数据;上线前请修改默认密码。# 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。
| 键 | 当前值 | 说明 |
|---|---|---|
db.host | 127.0.0.1 | 数据库地址;Docker 部署填服务名 mysql |
db.port | 3306 | MySQL 端口,默认 3306 |
db.name / user / pass | zij_pudn_cn / zij_pudn_cn | 库名、账号、密码;密码请勿使用示例值上线 |
db.charset | utf8mb4 | 固定 utf8mb4,勿改 |
engine | geometry+neural | mock=流程演示;http=转发自有算法服务 |
engine_api / engine_key | 预留 | 接入真实识别服务时填写,见 README 第 10.3 节 |
debug | false | 生产环境保持 false,错误只写 error_log |
page_size | 10 | 识别记录每页条数 |
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 本机访问即可。
/inc/config.php 返回 403/sql/init.sql 返回 403 / 404多为 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=表未建或字段不符,重新完整导入 sql/init.sql。
检查 assets/css/style.css 是否上传、Nginx 是否把静态资源交给 PHP 处理、文件权限是否 644。
Nginx 未套用 deny 规则或 Apache 未启用 .htaccess(需 AllowOverride All)。
更详尽的目录说明、安全加固、二次开发、接入真实识别引擎的接口规范,请查阅项目根目录的 README.md。本页为网页版速查,方便部署时直接在浏览器里对照操作。