FlyEnv+Bagisto安装遇到的一些问题

原创已于 2025-11-24 17:36:49 修改 · 303 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#android

于 2025-11-19 17:34:18 首次发布

FlyEnv+Bagisto 专栏收录该内容

3 篇文章

订阅专栏

Bagisto所需要的服务器配置

服务器配置

服务器：Apache 2 或 NGINX
内存：4GB或更高
节点：23.10.0 LTS或更高
PHP：8.2或更高
作曲家：2.5及以上

数据库

MySQL：版本8.0.32及以上
合计：（推荐）utf8mb4_unicode_ci

1.首先安装FlyEnv

https://flyenv.com/zh/

2025.11.24增加：安装FlyEnv之前需要先确认有没有安装运行库文件我按这样的WIN10,系统缺少瞎子啊按这样就行VC_redist.x64.exe

安装Nginx+php（composer）+mysql（utf8mb4_unicode_ci）(phpmyadmin)+Node.js

php-intl：国际化支持的必需
php-gd：图像处理和处理的必备工具
其他标准的Laravel扩展：通过命令进行检查php -m

然后安装laravel项目，制定文件夹/bagisto-2.3/public；

然后下载Bagisto git仓库不太好下载，会超时，使用国内镜像地址下载很快

bagisto:Free and open source laravel eCommerce platform - AtomGit | GitCode

先下好放本地，然后解压到bagisto-2.3；

2.先安装composer的所有依赖，必须，会将所有依赖下载到项目目录

首先更换源，要不然会有很多东西下载不到容易报错

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

composer install

3.根据官方文件安装Bagisto

运行指令

php artisan bagisto:install

然后报错

In ProviderRepository.php line 206:

Class "Laravel\Pail\PailServiceProvider" not found

此错误说明

虽然项目的composer.json文件中声明了laravel/sanctum依赖（版本^4.0），但在vendor/laravel目录下实际并没有安装这个包，这就是为什么会出现"Class Laravel\Sanctum\Sanctum not found"错误。

解决方案是运行composer命令重新安装缺失的依赖：

composer install

然后安装过程中报错

mpdf/mpdf ar-php

这两个包下载失败，然后从官网单独下载这两个包

https://github.com/khaled-alshamaa/ar-phpar-php https://github.com/khaled-alshamaa/ar-php

https://github.com/mpdf/mpdfmpdf/mpdf https://github.com/mpdf/mpdf

将文件进行解压

然后打开Bagisto项目的composer.json文件

在require部分添加本地路径映射：

   "repositories": [
        {
            "type": "path",
            "url": "./../BBB/ar-php-master",
            "options": {
                "symlink": false
            }
        },
        {
            "type": "path",
            "url": "./../BBB/mpdf-development",
            "options": {
                "symlink": false
            }
        }
    ],

然后执行

PS D:\bagisto-2.3> composer require khaled.alshamaa/ar-php mpdf/mpdf

如果不是包的问题，其他问题先忽略即可。

继续composer install如果还出错更换源

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

然后重新composer install 安装成功（需等待一会）

composer安装完成后，继续上述步骤

copy .env.example .env 配置文件设置好数据库和域名
php artisan key:generate 生成密钥

php artisan migrate:fresh --seed
php artisan storage:link
php artisan optimize:clear

然后

php artisan serve 启动商店

访问您的商店。http://localhost:8000

后台http://localhost:8000/admin

admin@example.com

admin123

第一次进会安装一下，至此成功安装

声明一下网页安装总是出错，建议使用命令安装

php artisan bagisto:install

按照交互式提示配置您的应用程序、数据库和管理员账户。

2025.11.21更新

中间又遇到了一些问题，更新一下，

1、php8.5自带php-fpm 不需要单独安装。如果出现无法解析，可能是单个域名的nginx配置文件启用不正确，官方给的🚀 Deployment | Bagisto中的nginx不是windows版本，windows中配置应该是，以下是我的windows配置，重点是fastcgi和目录不要配置错。

# 正确的Nginx配置示例，解决502 Bad Gateway错误
server {
    listen 80;
    server_name localhost;
    
    # 网站根目录
    root d:/bagisto-2.3/public;
    
    # 访问日志和错误日志 - 使用正斜杠
    access_log d:/PhpWebStudy-Data/server/vhost/nginx/access.log;
    error_log d:/PhpWebStudy-Data/server/vhost/nginx/error.log warn;
    
    # 默认文档
    index index.php index.html index.htm;

    # URL重写规则
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    
    # PHP文件处理 - 关键点：端口必须匹配PHP服务实际运行的端口
    location ~ \.php$ {
        try_files $uri =404;
        
        # 根据phpinfo()显示，PHP-FPM实际上在9085端口运行，而不是默认的9000端口
        fastcgi_pass 127.0.0.1:9085;
        
        # 正确设置SCRIPT_FILENAME
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        
        # 包含标准参数
        include fastcgi_params;
        
        # 设置合理的超时时间
        fastcgi_read_timeout 180;
    }
    
    # 静态文件缓存
    location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
        expires 30d;
        add_header Cache-Control "public, no-transform";
    }
    
    # 安全配置
    location ~ /\. {
        deny all;
    }
    
    location ~ /\.env {
        deny all;
    }
}

# 重要说明：
# 1. 端口号9085是根据phpinfo()中的配置文件路径"php.phpwebstudy.9085.ini"推断的
# 2. 请确保此端口与PHP FastCGI服务实际监听的端口一致
# 3. 所有Windows路径必须使用正斜杠(/)而不是反斜杠(\\)

2.FlvEnv默认有intl拓展，但是没有开启，需要在面板开启一下。