利用 Generators 快速构建 Laravel 应用

说明#

Laravel4 最吸引我的地方，就是其快速构建 App 的能力，其快速构架也得益于 Generators 这个 Package.

Generators 是一个代码生成器，允许你在执行一行命令的情况下快速生成代码文件，借鉴于 Ruby On Rails 的 rails generate 命令，见这里.

Jeffrey Way 的 Laravel-4-Generators , 很长一段时间在 http://packalyst.com/ 下载量排名第一，算是 Laravel 开发的时候最基本的 Package 了，见下图.

安装#

1. 编辑 `composer.json` 文件，加入 require package#

"require-dev": {
    "way/generators": "2.*"
}

2. 接下来，命令行下运行#

composer update --dev

3. 编辑 `app/config/app.php` 文件，加入 `providers`#

'Way\Generators\GeneratorsServiceProvider'

4. 这时候在命令行下运行#

php artisan

可以看到多了以下的命令

至此安装成功.

命令介绍#

generate:model --> 生成 model 文件；
generate:view --> 生成 view 文件，分别是 create, show, edit, delete ;
generate:controller --> 生成 restful controller;
generate:seed --> 数据库假数据填充文件；
generate:migration --> 数据库表结构描述文件；
generate:pivot --> 数据库关联表生成；
generate:resource --> 生成一堆文件，model + controller + view + seed + migration;
generate:scaffold --> 我最喜欢的命令，生成最多的代码，和 resource 类似的生成一堆文件，不同的是会在这些文件里面加入内容.

关于每个命令的使用，官方文档写的很清楚，这里就不继续讲了. 详细使用方法见这里.

generate:scaffold 脚手架一个应用#

这里演示下 generate:scaffold 能做的事情，以 phphub 的 topics 功能为例子:

php artisan generate:scaffold topic --fields="title:string, \
body:text, author:string, user_id:integer, node_id:integer,\
is_excellent:boolean, is_block:boolean, reply_count:integer, \
view_court:integer, favorite_count:integer, vote_count:integer"

执行上面命令得到下图:

下图是此次创建的文件列表:

咱们在看下 TopicsController.php 文件，基于 Restful Controller 的模版

<?php

class TopicsController extends \BaseController {

    /**
     * Display a listing of topics
     * 列表页面
     *
     * @return Response
     */
    public function index()
    {
        $topics = Topic::all();

        return View::make('topics.index', compact('topics'));
    }

    /**
     * Show the form for creating a new topic
     * 撰写主题页面
     *
     * @return Response
     */
    public function create()
    {
        return View::make('topics.create');
    }

    /**
     * Store a newly created topic in storage.
     * 接收 post 过来的数据, 并入库
     *
     * @return Response
     */
    public function store()
    {
        $validator = Validator::make($data = Input::all(), Topic::$rules);

        if ($validator->fails())
        {
            return Redirect::back()->withErrors($validator)->withInput();
        }

        Topic::create($data);

        return Redirect::route('topics.index');
    }

    /**
     * Display the specified topic.
     * 查看某个主题
     *
     * @param  int  $id
     * @return Response
     */
    public function show($id)
    {
        $topic = Topic::findOrFail($id);

        return View::make('topics.show', compact('topic'));
    }

    /**
     * Show the form for editing the specified topic.
     * 编辑主题页面
     *
     * @param  int  $id
     * @return Response
     */
    public function edit($id)
    {
        $topic = Topic::find($id);

        return View::make('topics.edit', compact('topic'));
    }

    /**
     * Update the specified topic in storage.
     * 接收 edit 页面 Post 过来的数据进行更新
     *
     * @param  int  $id
     * @return Response
     */
    public function update($id)
    {
        $topic = Topic::findOrFail($id);

        $validator = Validator::make($data = Input::all(), Topic::$rules);

        if ($validator->fails())
        {
            return Redirect::back()->withErrors($validator)->withInput();
        }

        $topic->update($data);

        return Redirect::route('topics.index');
    }

    /**
     * Remove the specified topic from storage.
     * 删除对应 $id 的信息
     * 
     * @param  int  $id
     * @return Response
     */
    public function destroy($id)
    {
        Topic::destroy($id);

        return Redirect::route('topics.index');
    }

}