README

Gondolyn - 基于Laravel的强大工具集

CodeShip Status

由Gondolyn提供的工具和方法是使用Gondolyn模块所必需的，这些模块包括账户和组，以实现更快的应用程序开发。

有关账户和组的更多信息，请查看各自的存储库。如果您需要一个简单的启动应用程序外壳，请查看GondolynShell。它预置了中间件定义、测试配置集和适当的模块composer配置。

作者

Matt Lantz (@mattylantz, mattlantz at gmail dot com)

Gondolyn的官方文档

整个包集合的文档可以在Gondolyn网站上找到。

要求

PHP 5.5.9+
OpenSSL

Composer安装

composer require "mlantz/gondolyn3"

添加到服务

Mlantz\Gondolyn\GondolynProvider::class

添加到ModelFactory.php

$factory = Module::factoryCollection($factory);

认证

如果您想使用Gondolyn账户和其他插件，请编辑您的`auth.php`配置中的以下行。

    'model' => App\Modules\Accounts\Models\Accounts::class

API组件

与Gondolyn3兼容的模块需要以下带有适当值的头。为了确保API组件与所需的模块一起工作，您需要将以下行添加到.htaccess文件中。

RewriteEngine On
RewriteCond %{HTTP:Authorization} ^(.*)
RewriteRule .* - [e=HTTP_AUTHORIZATION:%1]

Gondolyn: __KEY__
Authorization: Bearer __TOKEN__

安全域

为了确保订阅和其他组件能够正确运行，请将此内容添加到`.env`文件中。有关更多信息，请参阅SecurtyGuard中间件。

SAFE_DOMAINS=https://apis.google.com|https://www.google.com|http://fonts.googleapis.com|http://fonts.gstatic.com|https://js.stripe.com/v2/|https://maxcdn.bootstrap.ac.cn

数据库

将以下内容添加到您的`.env`文件中。

DB_CONNECTION=gondolyn

然后将其添加到您的数据库连接配置中。

'gondolyn' => [
    'driver'   => 'sqlite',
    'database' => database_path('gondolyn/gondolyn.sqlite'),
    'prefix'   => '',
],

邮件驱动程序

MAIL_DRIVER=sendmail

发布

php artisan vendor:publish --provider="Mlantz\Gondolyn\GondolynProvider"

中间件

确保您添加了中间件以帮助构建应用程序并确保模块功能。

必需

protected $middleware = [
    \Mlantz\Gondolyn\Middleware\Before::class,
    \Mlantz\Gondolyn\Middleware\TwoFactorAuthentication::class,
    \Mlantz\Gondolyn\Middleware\VerifyCsrfToken::class,
];

protected $routeMiddleware = [
    'before' => \Mlantz\Gondolyn\Middleware\Before::class,
    'cors' => \Mlantz\Gondolyn\Middleware\Cors::class,
    'security.guard' => \Mlantz\Gondolyn\Middleware\SecurityGuard::class,
    'permissions' => \Mlantz\Gondolyn\Middleware\PermissionsMatrix::class,
];

可选

protected $middleware = [
    \Mlantz\Gondolyn\Middleware\Cors::class,
    \Mlantz\Gondolyn\Middleware\SecurityGuard::class,
    \Mlantz\Gondolyn\Middleware\PermissionsMatrix::class,
    \Mlantz\Gondolyn\Middleware\TwoFactorAuthentication::class,
];

命令

php artisan gondolyn:module
php artisan gondolyn:module-migrate
php artisan gondolyn:dbuild
php artisan gondolyn:key
php artisan gondolyn:crud

单元测试

请确保在您的laravel或gondolynShell中，您需要将这些行添加到您的TestCase中。

use Mlantz\Gondolyn\Traits\GondolynTestTrait;

在`createApplication()`方法中的`return`之前添加此行。

$this->setUpGondolyn();

同时将其添加到您的`Phpunit.xml`文件中。

<testsuite name="Modules Test Suite">
    <directory>./app/Modules/</directory>
</testsuite>

mlantz / gondolyn3

维护者

详细信息