安装
<h1>安装</h1>
<p><a name="env"></a></p>
<h2>环境</h2>
<ul>
<li>PHP >= <code>7.1</code></li>
<li>Laravel <code>5.5.0</code> ~ <code>9.*</code></li>
<li>Fileinfo PHP Extension</li>
</ul>
<p><a name="start"></a></p>
<h2>开始安装</h2>
<p>> {tip} 如果安装过程中出现<code>composer</code>下载过慢或安装失败的情况，请运行命令<code>composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/</code>把<code>composer</code>镜像更换为阿里云镜像。</p>
<p>首先需要安装<code>laravel</code>，如已安装可以跳过此步骤</p>
<pre><code class="language-bash">composer create-project --prefer-dist laravel/laravel 项目名称 7.*
# 或
composer create-project --prefer-dist laravel/laravel 项目名称</code></pre>
<p>安装完<code>laravel</code>之后需要修改<code>.env</code>文件，设置数据库连接设置正确</p>
<pre><code class="language-dotenv">DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=dcat-admin
DB_USERNAME=root
DB_PASSWORD=</code></pre>
<p>安装<code>dcat-admin</code></p>
<pre><code>cd {项目名称}
composer require dcat/laravel-admin:&quot;2.*&quot; -vvv</code></pre>
<p>然后运行下面的命令来发布资源：</p>
<pre><code>php artisan admin:publish</code></pre>
<p>在该命令会生成配置文件<code>config/admin.php</code>，可以在里面修改安装的地址、数据库连接、以及表名，建议都是用默认配置不修改。</p>
<p>然后运行下面的命令完成安装：</p>
<p>> {tip} 执行这一步命令可能会报以下错误<code>Specified key was too long ... 767 bytes</code>，如果出现这个报错，请在<code>app/Providers/AppServiceProvider.php</code>文件的<code>boot</code>方法中加上代码<code>\Schema::defaultStringLength(191);</code>，然后删除掉数据库中的所有数据表，再重新运行一遍<code>php artisan admin:install</code>命令即可。</p>
<pre><code>php artisan admin:install</code></pre>
<p>上述步骤操作完成之后就可以配置<code>web</code>服务了，<strong>注意需要把<code>web</code>目录指向<code>public</code>目录</strong>！如果用的是<code>nginx</code>，还需要在配置中加上伪静态配置</p>
<pre><code class="language-dotenv">location / {
try_files $uri $uri/ /index.php?$query_string;
}</code></pre>
<p>启动服务后，在浏览器打开 <code>http://localhost/admin</code>，使用用户名 <code>admin</code> 和密码 <code>admin</code>登陆。</p>
<p><a name="files"></a></p>
<h2>生成的文件</h2>
<p>安装完成之后,会在项目目录中生成以下的文件:</p>
<p><a name="config"></a></p>
<h3>配置文件</h3>
<p>安装完成之后，<code>dcat-admin</code>所有的配置都在<code>config/admin.php</code>文件中。</p>
<p><a name="admin"></a></p>
<h3>后台项目文件</h3>
<p>安装完成之后，后台的安装目录为<code>app/Admin</code>，之后大部分的后台开发编码工作都是在这个目录下进行。</p>
<pre><code>app/Admin
├── Controllers
│ ├── AuthController.php
│ └── HomeController.php
├── Metrics
│ └── Examples
│ ├── NewDevices.php
│ ├── NewUsers.php
│ ├── ProductOrders.php
│ ├── Sessions.php
│ ├── Tickets.php
│ └── TotalUsers.php
├── bootstrap.php
└── routes.php</code></pre>
<ol>
<li><code>app/Admin/routes.php</code>文件用来配置后台路由。</li>
<li><code>app/Admin/bootstrap.php</code> 是<code>dcat-admin</code>的启动文件, 使用方法请参考文件里面的注释.</li>
<li><code>app/Admin/Controllers</code>目录用来存放后台控制器文件，该目录下的<code>HomeController.php</code>文件是后台首页的显示控制器，<code>AuthController.php</code>为后台管理员登录鉴权控制器。</li>
<li><code>app/Admin/Metrics/Examples</code>里面存放的是<code>数据统计卡片(Metric Card)</code>的示例代码.</li>
</ol>
<p><a name="assets"></a></p>
<h3>静态文件</h3>
<p>后台所需的前端静态文件在<code>/public/vendor/dcat-admin</code>目录下。</p>
<p><a name="migrations"></a></p>
<h3>数据表迁移文件</h3>
<p>对应的数据表迁移文件在<code>/database/migrations</code>目录下。</p>
<p><a name="lang"></a></p>
<h3>语言包</h3>
<p>语言包文件在<code>/resources/lang</code>目录下。</p>