安装

环境

  • PHP >= 8.2
  • Laravel >= 11.*

开始安装

安装laravel

首先需要安装laravel框架,如已安装可以跳过此步骤。如果您是第一次使用laravel,请务必先阅读 文档

composer create-project --prefer-dist laravel/laravel 项目名称 9.*
# 或
composer create-project --prefer-dist laravel/laravel 项目名称

安装完laravel之后需要修改.env文件,设置数据库连接设置正确

DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=owl_admin DB_USERNAME=root DB_PASSWORD=

如果有需要的话,在此时可以在config/app.php设置中文

locale 如下设置

'locale' => 'zh_CN',
注意

如果你使用的是 laravel 11 的话 还需要执行 php artisan install:api

安装owl-admin

cd {项目名称}

composer require slowlyo/owl-admin

然后运行下面的命令来发布资源:

php artisan admin:publish

在该命令会生成配置文件config/admin.php,可以在里面修改安装的地址、数据库连接、以及表名,建议都是用默认配置不修改。

然后运行下面的命令完成安装:

php artisan admin:install
Tips

执行这一步命令可能会报以下错误 Specified key was too long ... 767 bytes

如果出现这个报错,需手动修改配置文件:

config/database.php
'mysql'=>[
    // ...
-   'engine' => null,
+   'engine' => 'InnoDB',
]
然后删除掉数据库中的所有数据表,再重新运行一遍 php artisan admin:install

上述步骤操作完成之后就可以配置 web 服务了,注意需要把 web 目录也就是运行目录指向 public 目录

nginx 伪静态配置如下:

location / { try_files $uri $uri/ /index.php?$query_string; }

另外注意文件权限设置 755, 否则可能报错

启动服务后,在浏览器打开 http://localhost/admin,使用用户名 admin 和密码 admin登陆。

目录结构

. ├── app │ ├── Admin │ │ ├── Controllers │ │ │ ├── AuthController.php # 可以在这个控制器中重写登录等逻辑 │ │ │ ├── HomeController.php # 默认的后台控制台控制器 │ │ │ └── SettingController.php # 一个演示的控制器 │ │ ├── bootstrap.php # admin 启动时会加载这个文件 │ │ └── routes.php # admin 常规路由文件 ├── config │ └── admin.php # 框架配置文件 └── public └── admin-assets # 框架静态资源文件目录