安装

环境

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                    # 框架静态资源文件目录

安装#

环境#

开始安装#

安装 laravel#

安装 owl-admin#

目录结构#

安装

环境

开始安装

安装 `laravel`

安装 `owl-admin`

目录结构