laravel-admin安装教程？手把手教你建后台-php教程-PHP中文网

laravel-admin安装必须严格按依赖引入、资源发布、数据库初始化三步执行：先composer require指定1.9.*版本，再vendor:publish注册服务，最后admin:install建表；漏任一环将导致404/500且提示不明确。

laravel-admin安装教程？手把手教你建后台

laravel-admin 安装不是“配环境→敲命令→完事”，而是三步必须严丝合缝：依赖引入、资源发布、数据库初始化。漏掉任一环，访问 /admin 会直接报 404 或 500，且错误提示不指向真实原因。

确认 Laravel 版本和扩展是否就绪

不是所有 Laravel 版本都兼容最新 laravel-admin。当前（2026 年）稳定搭配是：

Laravel 10.x 或 11.x（laravel-admin 2.x 已停止维护，主推 1.x 分支）
PHP ≥ 8.0（laravel-admin 1.9+ 不再支持 PHP 7.x）
fileinfo 扩展必须启用（否则 admin:install 会卡在迁移前校验）
MySQL 表引擎推荐 InnoDB，字符集设为 utf8mb4_unicode_ci

检查方式：php -m | grep fileinfo；查 Laravel 版本：php artisan --version。如果 .env 数据库配置未生效，admin:install 会静默失败——务必先运行 php artisan tinker 执行 DB::connection()->getPdo() 确认连得上。

执行 install 命令前必须 publish

php artisan admin:install 不会自动发布配置和静态资源。它只做两件事：建表 + 插入默认账号。如果跳过 vendor:publish，config/admin.php 不存在，后续所有路由、菜单、权限逻辑都会崩。

正确顺序：

composer require encore/laravel-admin "1.9.*"（显式指定版本，避免拉到不稳定快照）
php artisan vendor:publish --provider="Encore\Admin\AdminServiceProvider"
php artisan admin:install

常见坑：vendor:publish 运行后若提示 “no assets to publish”，说明 ServiceProvider 没注册——检查 config/app.php 的 providers 数组是否手动加了 Encore\Admin\AdminServiceProvider::class（Laravel 5.5+ 可自动发现，但 Laravel 10/11 某些安装方式会关闭此功能）。

安装失败后不要反复重试

admin:install 是幂等操作，但只对「首次安装」安全。一旦中途失败（比如迁移卡住、密码哈希出错），再次运行会报 Table 'admin_users' already exists 或 Integrity constraint violation。

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

安全清理方式：

删掉数据库里所有 admin_* 表（admin_users、admin_roles、admin_permissions、admin_menu、admin_operation_log）
清空 config:cache 和 view:cache：php artisan config:clear && php artisan view:clear
确认 database/migrations 下没有残留的 create_admin_tables.php 迁移文件（admin:install 自带迁移，不需要手动跑 migrate）

如果仍报错，打开 storage/logs/laravel.log，搜索 admin:install，看具体卡在哪一行——大概率是 bcrypt() 调用失败（PHP 版本太低）或数据库字段长度不足（需在 AppServiceProvider 的 boot() 里加 Schema::defaultStringLength(191)）。