InvoicePlane需手动部署到phpEnv托管的Web服务器中，关键步骤包括：启用PDO/MBString/GD等PHP扩展、确保MySQL服务运行、将解压后的文件放入sites子目录并配置ipconfig.php中的URL与数据库参数一致、开启mod_rewrite及错误显示以排查500/404问题。
phpEnv 本身不“安装 InvoicePlane”，它只是 Windows 上的 PHP 运行环境管理工具；InvoicePlane 是一个基于 CodeIgniter 的 PHP Web 应用，需手动部署到 phpEnv 托管的 Apache/Nginx 下。关键在于路径权限、URL 配置和 ipconfig.php 中的协议/域名一致性——多数失败都卡在这三步。
phpEnv 环境是否满足 InvoicePlane 要求
InvoicePlane 官方要求 PHP ≥ 8.1、MySQL/MariaDB、PDO/MBString/GD 等扩展。phpEnv 8.11.0+ 版本默认支持 PHP 8.3/8.4，但需手动启用必要扩展：
- 打开 phpEnv 控制面板 → “PHP 设置” → 勾选
pdo_mysql、mbstring、gd、openssl、xml、json - 确认 MySQL 服务已启动（phpEnv 自带或外接）；若用内置 MySQL，密码默认为空，用户名为
root - Apache 端口建议设为
8080或8000（避免与 IIS/WSL 冲突），并在浏览器中访问http://localhost:8080确认环境正常
把 InvoicePlane 放进 phpEnv 的网站目录
InvoicePlane 不是 Composer 包，不能用 composer require 安装；必须解压后整体放入 phpEnv 的站点根目录（如 C:\phpEnv\sites\invoiceplane\）：
- 下载 ZIP 包（推荐）：从 https://www.php.cn/link/78cb63acd2888606f925551760b69f54 获取最新 release
- 解压后全量复制到
sites下新建文件夹（如invoiceplane），确保application/config/和uploads/可写（右键文件夹 → 属性 → 安全 → 编辑 → 添加IUSR或Users并勾选“修改”） - 重命名配置文件：
ipconfig.php.example→ipconfig.php，用记事本打开编辑：
define('IP_URL', 'http://localhost:8080'); // 必须与实际访问地址完全一致，含端口
define('IP_DB_HOST', '127.0.0.1'); // 不要用 localhost（Windows 下 mysqli 可能解析慢）
define('IP_DB_USER', 'root');
define('IP_DB_PASS', '');
define('IP_DB_NAME', 'invoiceplane');
⚠️ 错误示例：IP_URL 写成 http://127.0.0.1 却用 localhost 访问 → 后续登录跳转 404
立即学习“PHP免费学习笔记（深入）”；
运行 setup 时常见 500/404/白屏问题
phpEnv 默认关闭错误显示，导致白屏无提示；InvoicePlane 的 index.php/setup 路由依赖 Apache 的 mod_rewrite 和正确的 .htaccess：
- 在 phpEnv 控制面板 → “Apache 设置” → 开启
mod_rewrite（勾选并重启 Apache） - 确认项目根目录下存在
.htaccess文件（ZIP 包自带，勿删除） - 若仍 500，临时开启 PHP 错误：编辑
php.ini（phpEnv → PHP 设置 → 编辑 php.ini），改为：
display_errors = On error_reporting = E_ALL
然后重启 Apache，再访问 http://localhost:8080/index.php/setup，就能看到具体报错（如 mbstring.func_overload 已废弃 → 关闭该配置项）
数据库初始化失败：SQL 导入不生效
InvoicePlane 安装向导会自动建表，但首次运行前若数据库为空且权限不足，会卡在“连接数据库成功，但无法创建表”：
- 手动创建数据库（非必需，但更可控）：用 phpMyAdmin（phpEnv 自带）新建库
invoiceplane，排序规则选utf8mb4_unicode_ci - 检查
application/modules/setup/sql/下是否有mysql.sql；若缺失，说明 ZIP 包损坏，换一个下载源 - 确保
application/cache/和application/logs/目录可写（phpEnv 运行 Apache 服务账户需有权限） - 如果提示
Access denied for user 'root'@'localhost'，不是密码错，而是 MySQL 8+ 默认认证插件改了；此时需进 MySQL 命令行执行：ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '';
最易被忽略的是：phpEnv 的 Apache 默认 DocumentRoot 指向 sites，但 InvoicePlane 必须通过子目录访问（如 /invoiceplane/），不能直接放 sites 根下——否则 index.php 路由和静态资源路径全乱。
