Laravel 5 高性能电子商务扩展包 —— Aimeos Laravel

Aimeos Laravel
1、简介

扩展包Aimeos电商库集成到Laravel 5中,为我们提供了多个控制器用于多层过滤、产品列表、详情页展示、搜索、购物车和支付结算流程,以及对应的页面和路由,总之,这是一整套提供完整功能的工具集。

2、安装&更新

本文档介绍的是今年4月份发布的最新版本的Aimeos Laravel,我们通过Composer来完成安装,首先更新项目根目录下的composer.json

"prefer-stable": true,
    "minimum-stability": "dev",
    "require": {
        "aimeos/aimeos-laravel": "~2016.04",
        ...
    },
    "scripts": {
        ...
        "post-update-cmd": [
            "php artisan vendor:publish --tag=public --force",
            "php artisan vendor:publish",
            "php artisan migrate",
            ...
        ]
    }

然后运行更新命令:

composer update

注意:确保已经配置好了数据库。

接下来,需要在config/app.php中注册服务提供者:

return array(
    'providers' => array(
        ...
        Aimeos\Shop\ShopServiceProvider::class,
    ),
);

最后需要执行如下Artisan命令来执行或更新Aimeos安装:

php artisan vendor:publish
php artisan migrate
php artisan aimeos:setup --option=setup/default/demo:1
php artisan aimeos:cache

在生产环境中或者你不想插入演示数据,不要带上 --option=setup/default/demo:1选项。

在Laravel 5.1中,config/shop.phproutes部分需要做如下修改(因为5.1中没有中间件组web):

'routes' => array(
        'login' => array(),
        'admin' => array('middleware' => array('auth')),
        'account' => array('middleware' => array('auth')),
        'default' => array(),
        'confirm' => array(),
        'update' => array(),
    ),

3、设置

想要查看所有组件并让一切正常工作起来,还需要调整Blade模板resources/views/app.blade.php,这里是一个使用了Bootstrap的示例:

<!DOCTYPE html>
<html lang="en" class="no-js">
<head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
@yield('aimeos_header')
    <title>Aimeos on Laravel</title>

    <link href='//fonts.googleapis.com/css?family=Roboto:400,300' rel='stylesheet' type='text/css'>
    <link href="//maxcdn.bootstrapcdn.com/bootstrap/3.3.1/css/bootstrap.min.css" rel="stylesheet">
@yield('aimeos_styles')
</head>
<body>
    <nav class="navbar navbar-default">
    <div class="container-fluid">
            <div class="navbar-header">
                <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
                    <span class="sr-only">Toggle Navigation</span>
                    <span class="icon-bar"></span>
                    <span class="icon-bar"></span>
                    <span class="icon-bar"></span>
                </button>
                <a class="navbar-brand" href="#">Laravel</a>
            </div>

            <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
                <ul class="nav navbar-nav">
                    <li><a href="/">Home</a></li>
                </ul>

                <div class="navbar-right">
@yield('aimeos_head')
                </div>
            </div>
        </div>
    </nav>
    <div class="col-xs-12">
@yield('aimeos_nav')
@yield('aimeos_stage')
@yield('aimeos_body')
@yield('aimeos_aside')
@yield('content')
    </div>

    <!-- Scripts -->
    <script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.3/jquery.min.js"></script>
    <script src="//cdnjs.cloudflare.com/ajax/libs/modernizr/2.8.3/modernizr.min.js"></script>
    <script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.1/js/bootstrap.min.js"></script>
@yield('aimeos_scripts')
    </body>
</html>

此外,还要清除Laravel缓存文件,否则可能会因为老数据导致异常:

php artisan cache:clear

然后,需要在浏览器中调用目录列表:http://laravel.app/list

注意:默然开启了CSRF保护,但是排除了/confirm/update路由,如果支付提供者是通过POST发送数据记得在CSRF中禁止该路由。

4、后台

要使用后台系统,需要首先设置Laravel认证,具体认证实现请参考相应文档:

测试认证通过后,创建一个后台账户以便登录到后台系统:

php artisan aimeos:account  --admin

其中email用于后台登录用户名,这个创建的账户同样也可以用于前台登录,为了保护这个新账户,命令行会要求你输入账户密码。

最后一步,你需要扩展App\Providers\AuthServiceProvider类的boot()方法,定义后台认证用户的检查:

public function boot(GateContract $gate)
{
    // Keep the lines before

    $gate->define('admin', function($user) {
        return app( '\Aimeos\Shop\Base\Support' )->checkGroup( $user->id, 'admin' );
    });
}

如果你的./public目录对服务器而言不可写,需要设置其可写权限:

mkdir public/files public/preview public/uploads
chmod 777 public/files public/preview public/uploads

注意:在生产环境中,需要更加细粒度的分配权限。

后台访问地址为:http://laravel.app/admin

输入新创建账户的邮箱和密码登录后,如果没有跳转到后台页面,再次访问/admin页面。

5、小技巧

为了简化开发,需要配置不使用内容缓存,这可以通过配置config/shop.php来实现:

'madmin' => array(
        'cache' => array(
            'manager' => array(
                'name' => 'None',
            ),
        ),
    ),

更多详情,请参考其官方文档:https://aimeos.org/Laravel

学院君

学院君 has written 548 articles

资深PHP工程师,Laravel学院院长