laravel (5.1) & Ember.js (1.13.0) 的整合-PHP Tutorial-php.cn

laravel (5.1) & Ember.js (1.13.0) 的整合

WBOY

Release： 2016-06-20 12:50:38

Original

944 people have browsed it

Lavavel 不必过多介绍了，作为全世界最流行的PHP框架，有着清晰的架构、完善的文档、丰富的工具等等，能够帮助开发者快速构建多页面web应用程序。

然而，随着技术的发展，web程序的另一面??客户端，正在变得越来越多元（PC，手机，平板，其他专用设备等）。所以需要一种统一的机制，方便服务器与不同的设备进行通信。Restful API 就是基于这个思想被提出来的。

阮一峰给出了对Restful架构的总结：

每一个URI代表一种资源；

客户端和服务器之间，传递这种资源的某种表现层；

客户端通过四个HTTP动词，对服务器端资源进行操作，实现"表现层状态转化"。

从行为上讲，就是服务器在约定好一套资源交互规则之后，依据该规则，通过统一的API接口与不同的前端设备进行交互。服务器只需要专注于数据的存储与分析，或曰业务逻辑的实现。在不同客户端上，其表现逻辑和交互逻辑与服务器端的业务逻辑实现了双重分离??逻辑分离与物理分离。

如果前后端只有资源（数据）的交互，那么页面路由自然当交给前端控制，相当于前端在首次加载页面后就不再进行全页面的刷新，所有的数据通过ajax从后端随取随用，所有的表单提交也是同样方法，这就是一个单页面应用（Single Page Application, SPA）。

Ember.js是一个模块化的前端框架，基于MVC理念，它提供了UI绑定、模板系统、路由系统等功能，非常适合SPA的快速开发。特别是Ember还提供了一个完整的命令行开发包??Ember Cli，不仅省去了繁琐的开发环境配置，还提供了丰富的开发与构建工具，例如，你立即就可以用CoffeeScript甚至ES6进行开发，相应的解释器已经随开发包安装妥当，在启动 ember server 的情况下，你也不必每次改动都在命令行键入 ember build，系统自动识别文本改动并进行解释与合并，将编译好的文件放在 dist/ 目录下。

然而，当我把 Laravel 和 Ember.js 分别配置妥当之后，发现我并不能马上撸起袖子写代码，因为他们并不是为彼此而生的。例如，此时我就面临着两个问题：

Laravel 与 Ember.js 有各自的路由系统，如何让 laravel 出让自己对 URL 的控制？

用户授权通常是由服务器管理和维护的，Laravel 提供完整的 authentication 方案，但在SPA 中后端不得不出让一部分权限控制给前端（主要是页面访问权限和为ajax授权），解决这个问题的最佳实践是怎样的？

我相信之前已经有很多人遇到类似问题，该问题可能有通用的原则指导，但在操作层面与具体的框架相关，限于篇幅，本文讨论第一个问题。第二的问题另作回答。

定义API接口

在laravel中，laravel/app/Http/routes.php 文件是所有 URL 的入口，所有的 URL 和相应的处理函数都应当在这里定义。

// laravel/app/Http/routes.phpRoute::group( array( 'prefix' => 'api/v1' ), function(){    // USERS API ==================================    Route::get('users/{id}', 'UserController@getById');    Route::delete('users/{id}', 'UserController@destroyById');    Route::put('users/{id}', 'UserController@updateById');    Route::post('users', 'UserController@storeNew');    // OTHER API ==================================    // ......});

Copy after login

我将所有API放入一个路由组，这个组约定API请求必须以 api /【版本号】作为前缀，例如需要服务器返回 id=5 的用户信息，应当向如下地址发出 GET 请求：

http://your_demain/api/v1/users/5

服务器收到该请求后将 request 对象传递给 UserController 的 getById 成员方法做处理。

我还在该文件中定义了用户授权的相关接口，并将它们分在一组：

// laravel/app/Http/routes.phpRoute::group( array ( 'prefix' => 'auth' ), function(){    Route::post('login', 'Auth\AuthController@postLogin');    Route::get('logout', 'Auth\AuthController@getLogout');    Route::post('register', 'Auth\AuthController@postRegister');});

Copy after login

三个接口分别提供登录、登出和注册功能。

好了，laravel 的路由只需要做这么多事情。

将其他URL的控制权交给前端

Ember页面启动时以 ember/dist/index.html 文件作为入口，dist 目录存放着所有构建好的文件，均为系统自动生成。在 index.html 文件中，从ember/dist/assets 目录加载了2个脚本文件和2个样式文件：

<!-- ember/dist/index.html --><!DOCTYPE html><html>  <head>        <!-- 其他head标签 -->    <link rel="stylesheet" href="assets/vendor.css">    <link rel="stylesheet" href="assets/ember-app.css">      </head>  <body>        <script src="assets/vendor.js"></script>    <script src="assets/ember-app.js"></script>      </body></html>

Copy after login

这4个文件包含了所有前端的逻辑和样式。而 laravel 以 laravel/public 作为项目根目录，该目录下保存了由 laravel 构建好的前端资源。所以我的处理方式如下：

????同步 ember/dist/assets 与 laravel/public/assets 两个目录，后者是前者的镜像

??在 laravel/resources/views 定义一个 view 命名为 app.php，它的内容是 ember/dist/index.html 的拷贝??

??laravel 拿到除 API 与 AUTH 之外的请求（之后统称非API请求），均返回 app.php??????

在正常使用时，前端只在首次加载时发出非API请求，一旦拿到 app.php 前端就获得了对应用表现层的控制，只要不刷新页面，之后用户与应用的所有交互都将由前端捕捉与控制。

具体操作如下：

由于我在 windows 下做开发，系统不提供直接同步两个本地目录的工具，而且也没有找到实时自动同步的第三方桌面应用，最后选择了名为 InSync 的一款软件，每次同步都需要手动点击一下，是一个潜在的效率瓶颈。

在 laravel/resources/views 目录下创建 app.php 文件，将 ember/dist/index.html 的内容拷贝过来。

在 laravel/app/Http/routes.php 中创建一个新的路由分组：

// laravel/app/Http/routes.phpRoute::get('{data?}', function(){    return View::make('app');})->where('data', '.*');

Copy after login

该分组捕捉所有非API请求并返回 app.php。

前端具体实现

在Ember中，每个路由都有与之相关联的一个模型（Model）。Model 负责数据的查询、更改和将更改保存回服务器，这一过程是通过模型适配器（Adapter）完成的。所以需要修改适配器让它匹配后端所定义的 API 前缀约定：

// ember/app/adapters/application.jsexport default DS.RESTAdapter.extend({    namespace: 'api/v1'});

Copy after login

然后就可以在 ember/app/routers.js 中定义前端路由了：

// ember/app/routers.jsRouter.map(function() {    this.route('user', { path: '/user/:user_id' });    // Other routes ...});

Copy after login

这里有个不得不提的问题：

Ember 中每一个 Model 可以视为一种资源，而 Model 已经定义好了与这种资源的各种交户行为。例如当我定义好 userModel 之后，我要向服务器查询一条 user 记录可以使用如下代码，注释给出了它的网络请求（省略了前缀）：

this.store.find('user', 5);    // => GET '/users/5'

Copy after login

新建一个用户：

var user = this.store.createRecord('user', {      email: '123@123.com',      password: '123'});user.save();  // => POST to '/users'

Copy after login

这一默认行为是不可配置的，所以后端提供的 API 必须配合该规则进行构建，这也是使用大型框架所带来的灵活性的的缺失。在需要大量定制化功能的应用中，轻量级的前端框架例如 backbone 更具有竞争力。

Ember意识到了这个问题，在最新的2.0版本中，可以通过自定义服务（Service）来解决。

总结

至此，确定了页面加载方案，打通了前后端的数据交互通道，前后端由各自为政变成了相互协作、各司其职，应用终于“活”了起来。

Php8, I'm coming too

Learn website layout in 30 minutes

Shangguan Oracle Beginner to Proficient Video Tutorial

Your first line of UNI-APP code

Flutter from scratch to app launch

Brother Lian New Linux Video Tutorial

AXURE 9 Video Tutorial (Suitable for Product Manager Interactive Product Design UI)

Zero Basic Proficiency PS Video Tutorial

16 day UI video tutorial to get you started

PS Techniques and Slicing Techniques Video Tutorial

Alibaba Cloud Environment Construction and Project Launch Video Tutorial

Overview of Computer Networks - Basic Knowledge that Programmers Must Master

Essential Tutorial for Programmers - HTTP Protocol Explanation

Websocket Video Tutorial

laravel (5.1) & Ember.js (1.13.0) 的整合