phpEnv怎么安装InvoicePlane phpEnv搭建发票管理方法-php教程-PHP中文网

invoiceplane需手动部署到phpenv托管的web服务器中，关键步骤包括：启用pdo/mbstring/gd等php扩展、确保mysql服务运行、将解压后的文件放入sites子目录并配置ipconfig.php中的url与数据库参数一致、开启mod_rewrite及错误显示以排查500/404问题。

phpenv怎么安装invoiceplane phpenv搭建发票管理方法

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

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

运行 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 '';