Laravel 5 高性能电子商务扩展包 —— 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.php
的routes
部分需要做如下修改(因为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的示例:
@yield('aimeos_header')
Aimeos on Laravel
@yield('aimeos_styles')
@yield('aimeos_nav')
@yield('aimeos_stage')
@yield('aimeos_body')
@yield('aimeos_aside')
@yield('content')
<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')
此外,还要清除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
2 条评论