Windows本地部署Laundry Box POS及解决安装无响应、开机自启问题

一、替代XAMPP的本地/单机部署方案 #

StackOverflow社区普遍推荐的替代方案分为两类：

• 容器化方案：使用Docker将Laravel项目、PHP、MySQL打包为独立容器，彻底避免环境冲突，适合单机快速部署
• 原生环境部署：
  1. 从PHP官网下载匹配项目要求的Windows版本PHP，配置系统环境变量
  2. 安装MySQL Community Server，提前创建项目所需的数据库和权限用户
  3. 安装Nginx或Apache作为Web服务器，配置虚拟主机指向项目的public目录

二、Artisan安装依赖失败的解决步骤 #

1. 先核对项目composer.json中的PHP版本约束，确保本地PHP版本符合要求
2. 安装Composer并配置系统环境变量
3. 进入项目根目录，执行以下命令清理缓存并重新安装依赖：

   composer clear-cache
   composer install --no-dev --optimize-autoloader
   

   若遇权限问题，右键以管理员身份运行命令提示符，或检查项目目录的读写权限

三、安装页面「下一步」无反应的排查 #

1. 打开浏览器开发者工具（F12），查看Console标签的JS报错信息、Network标签的请求状态：
   • 若存在JS报错，需先安装Node.js，再执行npm install && npm run build编译前端资源
   • 若请求返回500或超时，检查.env文件的数据库配置（即使数据库已创建，也要确认用户名、密码、端口是否与MySQL配置一致）
2. 查看Laravel日志文件storage/logs/laravel.log，定位数据库连接或安装逻辑的具体报错
3. 手动完成安装流程：若安装脚本卡住，可执行以下命令手动迁移和填充数据，之后修改.env文件中APP_INSTALLED为true跳过安装页面：

   php artisan migrate
   php artisan db:seed
   

四、Windows开机自动启动Laravel项目（无需手动执行php artisan serve） #

方案1：使用Web服务器常驻运行 #

配置Nginx/Apache作为Web服务器后，将其注册为Windows服务实现开机自启：

• Nginx：下载Windows版本Nginx，执行命令创建服务：

  sc create Nginx binPath= "C:\nginx\nginx.exe" start= auto
  

• Apache：安装时选择将其注册为Windows服务，默认即可开机自启

方案2：将php artisan serve注册为Windows服务 #

使用NSSM（Non-Sucking Service Manager）工具实现：

1. 下载NSSM并添加到系统环境变量
2. 打开命令提示符，执行：

   nssm install LaundryPOS
   

3. 在弹出的配置窗口中：
   • Path：选择本地PHP的php.exe路径（如C:\php\php.exe）
   • Arguments：填写artisan serve --host=0.0.0.0 --port=8000
   • Working Directory：选择项目根目录
4. 点击「Install Service」完成注册，之后在系统服务管理器中设置该服务为自动启动

内容的提问来源于stack exchange，提问作者First Major