invoice ninja v5可用官方发行包在独立域名或子域名下部署:准备兼容的php、mysql或mariadb与https站点,把公开目录指向public,再通过/setup初始化数据库并配置每分钟调度。以下以linux上的nginx和php-fpm为例;v4实例应另建v5环境后迁移,不能直接覆盖升级。

官方手册的PHP环境与独立安装要求
先核对运行环境和发行包
官方手册以PHP 8.2及其扩展列出环境要求,当前v5-stable的composer.json允许PHP 8.2、8.3、8.4和8.5系列。按实际下载包的约束选择版本,并确保CLI与FPM均具备所需扩展,包括bcmath、ctype、imagick、soap、gd、mbstring、openssl、tokenizer、xml、curl、zip、gmp、iconv、mysqli和intl;电子发票校验另涉及Saxon。
数据库要求为MySQL 5.7及以上或MariaDB 10.3及以上兼容环境。先从官方GitHub Releases取得invoiceninja.tar,检查压缩包目录结构后解压至/var/www/invoiceninja,使artisan、public和配置文件处在正确层级。正式使用优先发行包;直接克隆Git仓库不包含可直接使用的React UI。
按发行包说明准备.env;新安装若提供.env.example,可复制为.env。将文件归属交给实际Web服务用户,目录通常使用755权限,配置文件仅向确有需要的服务用户开放。下面的www-data为Debian、Ubuntu常见示例,其他系统应替换。
sudo chown -R www-data:www-data /var/www/invoiceninja
sudo find /var/www/invoiceninja -type d -exec chmod 755 {} \;

发行包、文件归属与public站点目录
建立独立数据库并设置公开根目录
在数据库管理员会话中创建独立空库和应用账户。下面的口令是占位符,执行前必须更换;应用账户只获得该库的权限。
CREATE DATABASE invoiceninja CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'ninja'@'localhost' IDENTIFIED BY 'replace-with-a-long-password'; GRANT ALL PRIVILEGES ON invoiceninja.* TO 'ninja'@'localhost';
把以下目录与路由配置放入已启用HTTPS的站点server块,并替换域名、PHP-FPM套接字及实际路径。示例使用Debian、Ubuntu的fastcgi片段;不能把整个项目目录直接暴露到公网,也不支持把站点放在/ninja这类URL子目录下。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
server_name ninja.example.com;
root /var/www/invoiceninja/public;
index index.php index.html;
client_max_body_size 20M;
location = /index.php {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
}
location ~ \.php$ { return 403; }
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ /\.ht { deny all; }
运行nginx -t检查配置,通过后再按服务器原有方式重载nginx。访问https://ninja.example.com/setup,输入新建数据库的主机、库名、用户名和口令,完成安装向导。
调度与安装后验证
为应用服务用户配置每分钟执行一次Laravel调度。先确认/usr/bin/php指向兼容版本,多版本环境应使用正确的绝对路径。
* * * * * cd /var/www/invoiceninja && /usr/bin/php artisan schedule:run >> /var/www/invoiceninja/storage/logs/scheduler.log 2>&1
用同一服务用户手动运行一次php artisan schedule:run,检查退出结果与storage/logs中的日志;再确认Web界面可登录、数据库写入正常且调度日志可写。需要异步队列时,再按实际权限选择Supervisor或官方共享主机队列方案。数据库、.env及持久化文件应纳入可恢复备份,邮件服务则在公司级Email Settings中单独配置。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










