Artisan

// 在版本 5.1.11 新添加，见 http://d.laravel-china.org/docs/5.1/authorization#creating-policiesphp artisan make:policy PostPolicy// 针对命令显示帮助信息php artisan --help OR -h // 抑制输出信息php artisan --quiet OR -q // 打印 Laravel 的版本信息php artisan --version OR -V // 不询问任何交互性的问题php artisan --no-interaction OR -n // 强制输出 ANSI 格式php artisan --ansi // 禁止输出 ANSI 格式php artisan --no-ansi // 显示当前命令行运行的环境php artisan --env // -v|vv|vvv 通过增加 v 的个数来控制命令行输出内容的详尽情况: 1 个代表正常输出, 2 个代表输出更多消息, 3 个代表调试php artisan --verbose // 移除编译优化过的文件 (storage/frameworks/compiled.php)php artisan clear-compiled // 显示当前框架运行的环境php artisan env// 显示某个命令的帮助信息php artisan help// 显示所有可用的命令php artisan list// 进入应用交互模式php artisan tinker// 进入维护模式php artisan down// 退出维护模式php artisan up// 优化框架性能// --force 强制编译已写入文件 (storage/frameworks/compiled.php)// --psr 不对 Composer 的 dump-autoload 进行优化php artisan optimize [--force][--psr]// 启动内置服务器php artisan serve// 更改默认端口php artisan serve --port 8080// 使其在本地服务器外也可正常工作php artisan serve --host 0.0.0.0// 更改应用命名空间php artisan app:name namespace// 清除过期的密码重置令牌php artisan auth:clear-resets // 清空应用缓存php artisan cache:clear // 创建缓存数据库表 migrationphp artisan cache:table // 合并所有的配置信息为一个，提高加载速度php artisan config:cache // 移除配置缓存文件php artisan config:clear // 程序内部调用 Artisan 命令$exitCode =Artisan::call('config:cache');// 运行所有的 seed 假数据生成类// --class 可以指定运行的类，默认是: "DatabaseSeeder"// --database 可以指定数据库// --force 当处于生产环境时强制执行操作php artisan db:seed [--class[="..."]][--database[="..."]][--force]// 基于注册的信息，生成遗漏的 events 和 handlersphp artisan event:generate // 生成新的处理器类// --command 需要处理器处理的命令类名字php artisan handler:command [--command="..."]name // 创建一个新的时间处理器类// --event 需要处理器处理的事件类名字// --queued 需要处理器使用队列话处理的事件类名字php artisan handler:event[--event="..."][--queued]name // 生成应用的 key（会覆盖）php artisan key:generate // 在默认情况下, 这将创建未加入队列的自处理命令// 通过 --handler 标识来生成一个处理器, 用 --queued 来使其入队列.php artisan make:command [--handler] [--queued] name // 创建一个新的 Artisan 命令// --command 命令被调用的名称。 (默认为: "command:name")php artisan make:console [--command[="..."]] name // 创建一个新的资源控制器// --plain 生成一个空白的控制器类php artisan make:controller [--plain] name php artisan make:controller App\\Admin\\Http\\Controllers\\DashboardController // 创建一个新的事件类php artisan make:event name // 创建一个新的中间件类php artisan make:middleware name // 创建一个新的迁移文件// --create 将被创建的数据表.// --table 将被迁移的数据表.php artisan make:migration [--create[="..."]] [--table[="..."]] name // 创建一个新的 Eloquent 模型类php artisan make:model name // 创建一个新的服务提供者类php artisan make:provider name // 创建一个新的表单请求类php artisan make:request name // 数据库迁移// --database 指定数据库连接（下同）// --force 当处于生产环境时强制执行，不询问（下同）// --path 指定单独迁移文件地址// --pretend 把将要运行的 SQL 语句打印出来（下同）// --seed Seed 任务是否需要被重新运行（下同）php artisan migrate [--database[="..."]] [--force] [--path[="..."]] [--pretend] [--seed] // 创建迁移数据库表php artisan migrate:install [--database[="..."]] // 重置并重新运行所有的 migrations// --seeder 指定主 Seeder 的类名php artisan migrate:refresh [--database[="..."]] [--force] [--seed] [--seeder[="..."]] // 回滚所有的数据库迁移php artisan migrate:reset [--database[="..."]] [--force] [--pretend] // 回滚最最近一次运行的迁移任务php artisan migrate:rollback [--database[="..."]] [--force] [--pretend] // migrations 数据库表信息php artisan migrate:status // 为队列数据库表创建一个新的迁移php artisan queue:table // 监听指定的队列// --queue 被监听的队列// --delay 给执行失败的任务设置延时时间 (默认为零: 0)// --memory 内存限制大小，单位为 MB (默认为: 128)// --timeout 指定任务运行超时秒数 (默认为: 60)// --sleep 等待检查队列任务的秒数 (默认为: 3)// --tries 任务记录失败重试次数 (默认为: 0)php artisan queue:listen [--queue[="..."]] [--delay[="..."]] [--memory[="..."]] [--timeout[="..."]] [--sleep[="..."]] [--tries[="..."]] [connection] // 查看所有执行失败的队列任务php artisan queue:failed // 为执行失败的数据表任务创建一个迁移php artisan queue:failed-table // 清除所有执行失败的队列任务php artisan queue:flush // 删除一个执行失败的队列任务php artisan queue:forget // 在当前的队列任务执行完毕后, 重启队列的守护进程php artisan queue:restart // 对指定 id 的执行失败的队列任务进行重试(id: 失败队列任务的 ID)php artisan queue:retry id // 指定订阅 Iron.io 队列的链接// queue: Iron.io 的队列名称.// url: 将被订阅的 URL.// --type 指定队列的推送类型.php artisan queue:subscribe [--type[="..."]] queue url // 处理下一个队列任务// --queue 被监听的队列// --daemon 在后台模式运行// --delay 给执行失败的任务设置延时时间 (默认为零: 0)// --force 强制在「维护模式下」运行// --memory 内存限制大小，单位为 MB (默认为: 128)// --sleep 当没有任务处于有效状态时, 设置其进入休眠的秒数 (默认为: 3)// --tries 任务记录失败重试次数 (默认为: 0)php artisan queue:work [--queue[="..."]] [--daemon] [--delay[="..."]] [--force] [--memory[="..."]] [--sleep[="..."]] [--tries[="..."]] [connection] // 生成路由缓存文件来提升路由效率php artisan route:cache // 移除路由缓存文件php artisan route:clear // 显示已注册过的路由php artisan route:list // 运行计划命令php artisan schedule:run // 为 session 数据表生成迁移文件php artisan session:table // 从 vendor 的扩展包中发布任何可发布的资源// --force 重写所有已存在的文件// --provider 指定你想要发布资源文件的服务提供者// --tag 指定你想要发布标记资源.php artisan vendor:publish [--force] [--provider[="..."]] [--tag[="..."]] php artisan tail [--path[="..."]] [--lines[="..."]] [connection]

Composer

composer create-project laravel/laravel folder_name composer install composer update composer dump-autoload [--optimize]composer self-update composer require[options][--][vendor/packages]...

Config

Config::get('app.timezone');//指定默认值Config::get('app.timezone','UTC');Config::set('database.default','sqlite');

Route

Route::get('foo',function(){});Route::get('foo','ControllerName@function');Route::controller('foo','FooController');

资源路由

Route::resource('posts','PostsController');// 资源路由器只允许指定动作通过Route::resource('photo','PhotoController',['only'=>['index','show']]);Route::resource('photo','PhotoController',['except'=>['update','destroy']]);

触发错误

App::abort(404);$handler->missing(...)inErrorServiceProvider::boot();thrownewNotFoundHttpException;

路由参数

Route::get('foo/{bar}',function($bar){});Route::get('foo/{bar?}',function($bar ='bar'){});

HTTP 请求方式

Route::any('foo',function(){});Route::post('foo',function(){});Route::put('foo',function(){});Route::patch('foo',function(){});Route::delete('foo',function(){});// RESTful 资源控制器Route::resource('foo','FooController');// 为一个路由注册多种请求方式Route::match(['get','post'],'/',function(){});

安全路由 (TBD)

Route::get('foo',array('https',function(){}));

路由约束

Route::get('foo/{bar}',function($bar){})->where('bar','[0-9]+');Route::get('foo/{bar}/{baz}',function($bar,$baz){})->where(array('bar'=>'[0-9]+','baz'=>'[A-Za-z]'))

// 设置一个可跨路由使用的模式Route::pattern('bar','[0-9]+')

HTTP 中间件

// 为路由指定 MiddlewareRoute::get('admin/profile',['middleware'=>'auth',function(){}]);Route::get('admin/profile',function(){})->middleware('auth');

命名路由

Route::currentRouteName();Route::get('foo/bar',array('as'=>'foobar',function(){}));Route::get('user/profile',['as'=>'profile','uses'=>'UserController@showProfile']);Route::get('user/profile','UserController@showProfile')->name('profile');$url =route('profile');$redirect =redirect()->route('profile');

路由前缀

Route::group(['prefix'=>'admin'],function(){Route::get('users',function(){return'Matches The "/admin/users" URL';});});

路由命名空间

// 此路由组将会传送 'Foo\Bar' 命名空间Route::group(array('namespace'=>'Foo\Bar'),function(){})

子域名路由

// {sub} 将在闭包中被忽略Route::group(array('domain'=>'{sub}.example.com'),function(){});

Environment

$environment =app()->environment();$environment =App::environment();$environment =$app->environment();// 判断当环境是否为 localif($app->environment('local')){}// 判断当环境是否为 local 或 staging...if($app->environment('local','staging')){}

Log

// 记录器提供了 7 种在 RFC 5424 标准内定义的记录等级:// debug, info, notice, warning, error, critical, and alert.Log::info('info');Log::info('info',array('context'=>'additional info'));Log::error('error');Log::warning('warning');// 获取 monolog 实例Log::getMonolog();// 添加监听器Log::listen(function($level,$message,$context){});

记录 SQL 查询语句

// 开启 logDB::connection()->enableQueryLog();// 获取已执行的查询数组DB::getQueryLog();

URL

URL::full();URL::current();URL::previous();URL::to('foo/bar',$parameters,$secure);URL::action('NewsController@item',['id'=>123]);// 需要在适当的命名空间内URL::action('Auth\AuthController@logout');URL::action('FooController@method',$parameters,$absolute);URL::route('foo',$parameters,$absolute);URL::secure('foo/bar',$parameters);URL::asset('css/foo.css',$secure);URL::secureAsset('css/foo.css');URL::isValidUrl('http://example.com');URL::getRequest();URL::setRequest($request);

Event

Event::fire('foo.bar',array($bar));// 注册一个事件监听器.// void listen(string|array $events, mixed $listener, int $priority)Event::listen('App\Events\UserSignup',function($bar){});Event::listen('foo.*',function($bar){});Event::listen('foo.bar','FooHandler',10);Event::listen('foo.bar','BarHandler',5);// 你可以直接在处理逻辑中返回 false 来停止一个事件的传播.Event::listen('foor.bar',function($event){returnfalse;});Event::subscribe('UserEventHandler');

DB

基本使用

DB::connection('connection_name');// 运行数据库查询语句$results =DB::select('select * from users where id = ?',[1]);$results =DB::select('select * from users where id = :id',['id'=>1]);// 运行普通语句DB::statement('drop table users');// 监听查询事件DB::listen(function($sql,$bindings,$time){code_here;});// 数据库事务处理DB::transaction(function(){DB::table('users')->update(['votes'=>1]);DB::table('posts')->delete();});DB::beginTransaction();DB::rollBack();DB::commit();

查询语句构造器

// 取得数据表的所有行DB::table('name')->get();// 取数据表的部分数据DB::table('users')->chunk(100,function($users){foreach($users as$user){//}});// 取回数据表的第一条数据$user =DB::table('users')->where('name','John')->first();DB::table('name')->first();// 从单行中取出单列数据$name =DB::table('users')->where('name','John')->pluck('name');DB::table('name')->pluck('column');// 取多行数据的「列数据」数组$roles =DB::table('roles')->lists('title');$roles =DB::table('roles')->lists('title','name');// 指定一个选择字句$users =DB::table('users')->select('name','email')->get();$users =DB::table('users')->distinct()->get();$users =DB::table('users')->select('name as user_name')->get();// 添加一个选择字句到一个已存在的查询语句中$query =DB::table('users')->select('name');$users =$query->addSelect('age')->get(); // 使用 Where 运算符$users = DB::table('users')->where('votes', '>', 100)->get(); $users = DB::table('users') ->where('votes', '>', 100) ->orWhere('name', 'John') ->get(); $users = DB::table('users') ->whereBetween('votes', [1, 100])->get(); $users = DB::table('users') ->whereNotBetween('votes', [1, 100])->get(); $users = DB::table('users') ->whereIn('id', [1, 2, 3])->get(); $users = DB::table('users') ->whereNotIn('id', [1, 2, 3])->get(); $users = DB::table('users') ->whereNull('updated_at')->get(); DB::table('name')->whereNotNull('column')->get(); // 动态的 Where 字句$admin = DB::table('users')->whereId(1)->first(); $john = DB::table('users') ->whereIdAndEmail(2, 'john@doe.com') ->first(); $jane = DB::table('users') ->whereNameOrAge('Jane', 22) ->first(); // Order By, Group By, 和 Having$users = DB::table('users') ->orderBy('name', 'desc') ->groupBy('count') ->having('count', '>', 100) ->get(); DB::table('name')->orderBy('column')->get(); DB::table('name')->orderBy('column','desc')->get(); DB::table('name')->having('count', '>', 100)->get(); // 偏移 & 限制$users = DB::table('users')->skip(10)->take(5)->get();

Joins

// 基本的 Join 声明语句DB::table('users')->join('contacts','users.id','=','contacts.user_id')->join('orders','users.id','=','orders.user_id')->select('users.id','contacts.phone','orders.price')->get();// Left Join 声明语句DB::table('users')->leftJoin('posts','users.id','=','posts.user_id')->get();// select * from users where name = 'John' or (votes > 100 and title <> 'Admin')DB::table('users')->where('name','=','John')->orWhere(function($query){$query->where('votes','>',100)->where('title','<>','Admin');})->get();

聚合

$users =DB::table('users')->count();$price =DB::table('orders')->max('price');$price =DB::table('orders')->min('price');$price =DB::table('orders')->avg('price');$total =DB::table('users')->sum('votes');

原始表达句

$users =DB::table('users')->select(DB::raw('count(*) as user_count, status'))->where('status','<>',1)->groupBy('status')->get();// 返回行DB::select('select * from users where id = ?',array('value'));DB::insert('insert into foo set bar=2');DB::update('update foo set bar=2');DB::delete('delete from bar');// 返回 voidDB::statement('update foo set bar=2');// 在声明语句中加入原始的表达式DB::table('name')->select(DB::raw('count(*) as count, column2'))->get();

Inserts / Updates / Deletes / Unions / Pessimistic Locking

// 插入DB::table('users')->insert(['email'=>'john@example.com','votes'=>0]);$id =DB::table('users')->insertGetId(['email'=>'john@example.com','votes'=>0]);DB::table('users')->insert([['email'=>'taylor@example.com','votes'=>0],['email'=>'dayle@example.com','votes'=>0]]);// 更新DB::table('users')->where('id',1)->update(['votes'=>1]);DB::table('users')->increment('votes');DB::table('users')->increment('votes',5);DB::table('users')->decrement('votes');DB::table('users')->decrement('votes',5);DB::table('users')->increment('votes',1,['name'=>'John']);// 删除DB::table('users')->where('votes', '<', 100)->delete(); DB::table('users')->delete(); DB::table('users')->truncate(); // 集合// unionAll() 方法也是可供使用的，调用方式与 union 相似$first = DB::table('users')->whereNull('first_name'); $users = DB::table('users')->whereNull('last_name')->union($first)->get(); // 消极锁DB::table('users')->where('votes', '>', 100)->sharedLock()->get(); DB::table('users')->where('votes', '>', 100)->lockForUpdate()->get();

Model

基础使用

// 定义一个 Eloquent 模型classUserextendsModel{}// 生成一个 Eloquent 模型php artisan make:model User// 指定一个自定义的数据表名称classUserextendsModel{protected$table ='my_users';}

More

Model::create(array('key'=>'value'));// 通过属性找到第一条相匹配的数据或创造一条新数据Model::firstOrCreate(array('key'=>'value'));// 通过属性找到第一条相匹配的数据或实例化一条新数据Model::firstOrNew(array('key'=>'value'));// 通过属性找到相匹配的数据并更新，如果不存在即创建Model::updateOrCreate(array('search_key'=>'search_value'),array('key'=>'value'));// 使用属性的数组来填充一个模型, 用的时候要小心「Mass Assignment」安全问题 !Model::fill($attributes);Model::destroy(1);Model::all();Model::find(1);// 使用双主键进行查找Model::find(array('first','last'));// 查找失败时抛出异常Model::findOrFail(1);// 使用双主键进行查找, 失败时抛出异常Model::findOrFail(array('first','last'));Model::where('foo','=','bar')->get();Model::where('foo','=','bar')->first();Model::where('foo','=','bar')->exists();// 动态属性查找Model::whereFoo('bar')->first();// 查找失败时抛出异常Model::where('foo','=', 'bar')->firstOrFail(); Model::where('foo', '=', 'bar')->count(); Model::where('foo', '=', 'bar')->delete(); // 输出原始的查询语句Model::where('foo', '=', 'bar')->toSql(); Model::whereRaw('foo = bar and cars = 2', array(20))->get(); Model::on('connection-name')->find(1); Model::with('relation')->get(); Model::all()->take(10); Model::all()->skip(10); // 默认的 Eloquent 排序是上升排序Model::all()->orderBy('column'); Model::all()->orderBy('column','desc');

软删除

Model::withTrashed()->where('cars',2)->get();// 在查询结果中包括带被软删除的模型Model::withTrashed()->where('cars',2)->restore();Model::where('cars',2)->forceDelete();// 查找只带有软删除的模型Model::onlyTrashed()->where('cars',2)->get();

模型关联

// 一对一 - User::phone()return$this->hasOne('App\Phone','foreign_key','local_key');// 一对一 - Phone::user(), 定义相对的关联return$this->belongsTo('App\User','foreign_key','other_key');// 一对多 - Post::comments()return$this->hasMany('App\Comment','foreign_key','local_key');// 一对多 - Comment::post()return$this->belongsTo('App\Post','foreign_key','other_key');// 多对多 - User::roles();return$this->belongsToMany('App\Role','user_roles','user_id','role_id');// 多对多 - Role::users();return$this->belongsToMany('App\User');// 多对多 - Retrieving Intermediate Table Columns$role->pivot->created_at;// 多对多 - 中介表字段return$this->belongsToMany('App\Role')->withPivot('column1','column2');// 多对多 - 自动维护 created_at 和 updated_at 时间戳return$this->belongsToMany('App\Role')->withTimestamps();// 远层一对多 - Country::posts(), 一个 Country 模型可能通过中介的 Users// 模型关联到多个 Posts 模型(User::country_id)return$this->hasManyThrough('App\Post','App\User','country_id','user_id');// 多态关联 - Photo::imageable()return$this->morphTo();// 多态关联 - Staff::photos()return$this->morphMany('App\Photo','imageable');// 多态关联 - Product::photos()return$this->morphMany('App\Photo','imageable');// 多态关联 - 在 AppServiceProvider 中注册你的「多态对照表」Relation::morphMap(['Post'=>App\Post::class, 'Comment' => App\Comment::class, ]); // 多态多对多关联 - 涉及数据库表: posts,videos,tags,taggables// Post::tags()return $this->morphToMany('App\Tag', 'taggable'); // Video::tags()return $this->morphToMany('App\Tag', 'taggable'); // Tag::posts()return $this->morphedByMany('App\Post', 'taggable'); // Tag::videos()return $this->morphedByMany('App\Video', 'taggable'); // 查找关联$user->posts()->where('active', 1)->get(); // 获取所有至少有一篇评论的文章...$posts = App\Post::has('comments')->get(); // 获取所有至少有三篇评论的文章...$posts = Post::has('comments', '>=', 3)->get(); // 获取所有至少有一篇评论被评分的文章...$posts = Post::has('comments.votes')->get(); // 获取所有至少有一篇评论相似于 foo% 的文章$posts = Post::whereHas('comments', function ($query) { $query->where('content', 'like', 'foo%'); })->get(); // 预加载$books = App\Book::with('author')->get(); $books = App\Book::with('author', 'publisher')->get(); $books = App\Book::with('author.contacts')->get(); // 延迟预加载$books->load('author', 'publisher'); // 写入关联模型$comment = new App\Comment(['message' => 'A new comment.']); $post->comments()->save($comment); // Save 与多对多关联$post->comments()->saveMany([ new App\Comment(['message' => 'A new comment.']), new App\Comment(['message' => 'Another comment.']), ]); $post->comments()->create(['message' => 'A new comment.']); // 更新「从属」关联$user->account()->associate($account); $user->save(); $user->account()->dissociate(); $user->save(); // 附加多对多关系$user->roles()->attach($roleId); $user->roles()->attach($roleId, ['expires' => $expires]); // 从用户上移除单一身份...$user->roles()->detach($roleId); // 从用户上移除所有身份...$user->roles()->detach(); $user->roles()->detach([1, 2, 3]); $user->roles()->attach([1 => ['expires' => $expires], 2, 3]); // 任何不在给定数组中的 IDs 将会从中介表中被删除。$user->roles()->sync([1, 2, 3]); // 你也可以传递中介表上该 IDs 额外的值：$user->roles()->sync([1 => ['expires' => true], 2, 3]); 事件 Model::creating(function($model){}); Model::created(function($model){}); Model::updating(function($model){}); Model::updated(function($model){}); Model::saving(function($model){}); Model::saved(function($model){}); Model::deleting(function($model){}); Model::deleted(function($model){}); Model::observe(new FooObserver); Eloquent 配置信息 // 关闭模型插入或更新操作引发的 「mass assignment」异常Eloquent::unguard(); // 重新开启「mass assignment」异常抛出功能Eloquent::reguard();

Pagination

// 自动处理分页逻辑Model::paginate(15);Model::where('cars',2)->paginate(15);// 使用简单模板 - 只有 "上一页" 或 "下一页" 链接Model::where('cars',2)->simplePaginate(15);// 手动分页Paginator::make($items,$totalItems,$perPage);// 在页面打印分页导航栏$variable->links();

Lang

App::setLocale('en');Lang::get('messages.welcome');Lang::get('messages.welcome',array('foo'=>'Bar'));Lang::has('messages.welcome');Lang::choice('messages.apples',10);// Lang::get 的别名trans('messages.welcome');

File

File::exists('path');File::get('path');File::getRemote('path');// 获取文件内容File::getRequire('path');// 获取文件内容, 仅能引入一次File::requireOnce('path');// 将内容写入文件File::put('path','contents');// 将内容添加在文件原内容后File::append('path','data');// 通过给定的路径来删除文件File::delete('path');// 将文件移动到新目录下File::move('path','target');// Copy a file to a new location// 将文件复制到新目录下File::copy('path','target');// 从文件的路径地址提取文件的扩展File::extension('path');// 获取文件类型File::type('path');// 获取文件大小File::size('path');// 获取文件的最后修改时间File::lastModified('path');// 判断给定的路径是否是文件目录File::isDirectory('directory');// 判断给定的路径是否是可写入的File::isWritable('path');// 判断给定的路径是否是文件File::isFile('file');// 查找能被匹配到的路径名File::glob($patterns,$flag);// Get an array of all files in a directory.// 获取一个目录下的所有文件, 以数组类型返回File::files('directory');// 获取一个目录下的所有文件 (递归).File::allFiles('directory');// 获取一个目录内的目录File::directories('directory'); // 创建一个目录File::makeDirectory('path', $mode = 0777, $recursive = false); // 将文件夹从一个目录复制到另一个目录下File::copyDirectory('directory', 'destination', $options = null); // 递归式删除目录File::deleteDirectory('directory', $preserve = false); // 清空指定目录的所有文件和文件夹File::cleanDirectory('directory');

UnitTest

Install and run

// 将其加入到 composer.json 并更新:composer require"phpunit/phpunit:4.0.*"// 运行测试 (在项目根目录下运行)./vendor/bin/phpunit

Asserts

$this->assertTrue(true);$this->assertEquals('foo',$bar);$this->assertCount(1,$times);$this->assertResponseOk();$this->assertResponseStatus(403);$this->assertRedirectedTo('foo');$this->assertRedirectedToRoute('route.name');$this->assertRedirectedToAction('Controller@method');$this->assertViewHas('name');$this->assertViewHas('age',$value);$this->assertSessionHasErrors();// 由单个 key 值来假定 session 有错误...$this->assertSessionHasErrors('name');// 由多个 key 值来假定 session 有错误...$this->assertSessionHasErrors(array('name','age'));$this->assertHasOldInput();

Calling routes

$response =$this->call($method,$uri,$parameters,$files,$server,$content);$response =$this->callSecure('GET','foo/bar');$this->session(['foo'=>'bar']);$this->flushSession();$this->seed();$this->seed($connection);

SSH

Executing Commands

SSH::run(array $commands);// 指定 remote, 否则将使用默认值SSH::into($remote)->run(array $commands);SSH::run(array $commands,function($line){echo $line.PHP_EOL;});

任务

// 定义任务SSH::define($taskName,array $commands);// 执行任务SSH::task($taskName,function($line){echo $line.PHP_EOL;});

SFTP 上传

SSH::put($localFile,$remotePath);SSH::putString($string,$remotePath);

Schema

// 创建指定数据表Schema::create('table',function($table){$table->increments('id');});// 指定一个连接Schema::connection('foo')->create('table',function($table){});// 通过给定的名称来重命名数据表Schema::rename($from,$to);// 移除指定数据表Schema::drop('table');// 当数据表存在时, 将指定数据表移除Schema::dropIfExists('table');// 判断数据表是否存在Schema::hasTable('table');// 判断数据表是否有该列Schema::hasColumn('table','column');// 更新一个已存在的数据表Schema::table('table',function($table){});// 重命名数据表的列$table->renameColumn('from','to');// 移除指定的数据表列$table->dropColumn(string|array);// 指定数据表使用的存储引擎$table->engine ='InnoDB';// 字段顺序，只能在 MySQL 中才能用$table->string('name')->after('email');

索引

$table->string('column')->unique();$table->primary('column');// 创建一个双主键$table->primary(array('first','last'));$table->unique('column');$table->unique('column','key_name');// 创建一个双唯一性索引$table->unique(array('first','last'));$table->unique(array('first','last'),'key_name');$table->index('column');$table->index('column','key_name');// 创建一个双索引$table->index(array('first','last'));$table->index(array('first','last'),'key_name');$table->dropPrimary(array('column'));$table->dropPrimary('table_column_primary');$table->dropUnique(array('column'));$table->dropUnique('table_column_unique');$table->dropIndex(array('column'));$table->dropIndex('table_column_index');

外键

$table->foreign('user_id')->references('id')->on('users');$table->foreign('user_id')->references('id')->on('users')->onDelete('cascade'|'restrict'|'set null'|'no action');$table->foreign('user_id')->references('id')->on('users')->onUpdate('cascade'|'restrict'|'set null'|'no action');$table->dropForeign(array('user_id'));$table->dropForeign('posts_user_id_foreign');

字段类型

// 自增$table->increments('id');$table->bigIncrements('id');// 数字$table->integer('votes');$table->tinyInteger('votes');$table->smallInteger('votes');$table->mediumInteger('votes');$table->bigInteger('votes');$table->float('amount');$table->double('column',15,8);$table->decimal('amount',5,2);// 字符串和文本$table->char('name',4);$table->string('email');$table->string('name',100);$table->text('description');$table->mediumText('description');$table->longText('description');// 日期和时间$table->date('created_at');$table->dateTime('created_at');$table->time('sunrise');$table->timestamp('added_on');// Adds created_at and updated_at columns// 添加 created_at 和 updated_at 行$table->timestamps();$table->nullableTimestamps();// 其它类型$table->binary('data');$table->boolean('confirmed');// 为软删除添加 deleted_at 字段$table->softDeletes();$table->enum('choices',array('foo','bar'));// 添加 remember_token 为 VARCHAR(100) NULL$table->rememberToken();// 添加整型的 parent_id 和字符串类型的 parent_type$table->morphs('parent'); ->nullable() ->default($value) ->unsigned()

Input

Input::get('key');// 指定默认值Input::get('key','default');Input::has('key');Input::all();// 只取回 'foo' 和 'bar'，返回数组Input::only('foo','bar');// 取除了 'foo' 的所有用户输入数组Input::except('foo');Input::flush();

会话周期内 Input

// 清除会话周期内的输入Input::flash();// 清除会话周期内的指定输入Input::flashOnly('foo','bar');// 清除会话周期内的除了指定的其他输入Input::flashExcept('foo','baz');// 取回一个旧的输入条目Input::old('key','default_value');

Files

// 使用一个已上传的文件Input::file('filename');// 判断文件是否已上传Input::hasFile('filename');// 获取文件属性Input::file('name')->getRealPath();Input::file('name')->getClientOriginalName();Input::file('name')->getClientOriginalExtension();Input::file('name')->getSize();Input::file('name')->getMimeType();// 移动一个已上传的文件Input::file('name')->move($destinationPath);// 移动一个已上传的文件，并设置新的名字Input::file('name')->move($destinationPath,$fileName);

Cache

Cache::put('key','value',$minutes);Cache::add('key','value',$minutes);Cache::forever('key','value');Cache::remember('key',$minutes,function(){return'value'});Cache::rememberForever('key',function(){return'value'});Cache::forget('key');Cache::has('key');Cache::get('key');Cache::get('key','default');Cache::get('key',function(){return'default';});Cache::tags('my-tag')->put('key','value',$minutes);Cache::tags('my-tag')->has('key');Cache::tags('my-tag')->get('key');Cache::tags('my-tag')->forget('key');Cache::tags('my-tag')->flush();Cache::increment('key');Cache::increment('key',$amount);Cache::decrement('key');Cache::decrement('key', $amount); Cache::section('group')->put('key', $value); Cache::section('group')->get('key'); Cache::section('group')->flush();

Cookie

Cookie::get('key');Cookie::get('key','default');// 创建一个永久有效的 cookieCookie::forever('key','value');// 创建一个 N 分钟有效的 cookieCookie::make('key','value','minutes');// 在回应之前先积累 cookie，回应时统一返回Cookie::queue('key','value','minutes');// 移除 CookieCookie::forget('key');// 从 response 发送一个 cookie$response =Response::make('Hello World');$response->withCookie(Cookie::make('name','value',$minutes));

Session

Session::get('key');// 从会话中读取一个条目Session::get('key','default');Session::get('key',function(){return'default';});// 获取 session 的 IDSession::getId();// 增加一个会话键值数据Session::put('key','value');// 将一个值加入到 session 的数组中Session::push('foo.bar','value');// 返回 session 的所有条目Session::all();// 检查 session 里是否有此条目Session::has('key');// 从 session 中移除一个条目Session::forget('key');// 从 session 中移除所有条目Session::flush();// 生成一个新的 session 标识符Session::regenerate();// 把一条数据暂存到 session 中Session::flash('key','value');// 清空所有的暂存数据Session::reflash();// 重新暂存当前暂存数据的子集Session::keep(array('key1','key2'));

Request

// url: http://xx.com/aa/bbRequest::url();// 路径: /aa/bbRequest::path();// 获取请求 Uri: /aa/bb/?c=dRequest::getRequestUri();// 返回用户的 IPRequest::ip();// 获取 Uri: http://xx.com/aa/bb/?c=dRequest::getUri();// 获取查询字符串: c=dRequest::getQueryString();// 获取请求端口 (例如 80, 443 等等)Request::getPort();// 判断当前请求的 URI 是否可被匹配Request::is('foo/*');// 获取 URI 的分段值 (索引从 1 开始)Request::segment(1);// 从请求中取回头部信息Request::header('Content-Type');// 从请求中取回服务器变量Request::server('PATH_INFO');// 判断请求是否是 AJAX 请求Request::ajax();// 判断请求是否使用 HTTPSRequest::secure();// 获取请求方法Request::method();// 判断请求方法是否是指定类型的Request::isMethod('post');// 获取原始的 POST 数据Request::instance()->getContent();// 获取请求要求返回的格式Request::format();// 判断 HTTP Content-Type 头部信息是否包含 */jsonRequest::isJson();// 判断 HTTP Accept 头部信息是否为 application/jsonRequest::wantsJson();

Response

returnResponse::make($contents);returnResponse::make($contents,200);returnResponse::json(array('key'=>'value'));returnResponse::json(array('key'=>'value'))->setCallback(Input::get('callback'));returnResponse::download($filepath);returnResponse::download($filepath,$filename,$headers);// 创建一个回应且修改其头部信息的值$response =Response::make($contents,200);$response->header('Content-Type','application/json');return$response;// 为回应附加上 cookiereturnResponse::make($content)->withCookie(Cookie::make('key','value'));

Redirect

returnRedirect::to('foo/bar');returnRedirect::to('foo/bar')->with('key','value');returnRedirect::to('foo/bar')->withInput(Input::get());returnRedirect::to('foo/bar')->withInput(Input::except('password'));returnRedirect::to('foo/bar')->withErrors($validator);// 重定向到之前的请求returnRedirect::back();// 重定向到命名路由（根据命名路由算出 URL）returnRedirect::route('foobar');returnRedirect::route('foobar',array('value'));returnRedirect::route('foobar',array('key'=>'value'));// 重定向到控制器动作（根据控制器动作算出 URL）returnRedirect::action('FooController@index');returnRedirect::action('FooController@baz',array('value'));returnRedirect::action('FooController@baz',array('key'=>'value'));// 跳转到目的地址，如果没有设置则使用默认值 foo/barreturnRedirect::intended('foo/bar');

Container

App::bind('foo',function($app){returnnewFoo;});App::make('foo');// 如果存在此类, 则返回App::make('FooBar');// 单例模式实例到服务容器中App::singleton('foo',function(){returnnewFoo;});// 将已实例化的对象注册到服务容器中App::instance('foo',newFoo);// 注册绑定规则到服务容器中App::bind('FooRepositoryInterface','BarRepository');// 给应用注册一个服务提供者App::register('FooServiceProvider');// 监听容器对某个对象的解析App::resolving(function($object){});

Security

哈希

Hash::make('secretpassword');Hash::check('secretpassword',$hashedPassword);Hash::needsRehash($hashedPassword);

加密解密

Crypt::encrypt('secretstring');Crypt::decrypt($encryptedString);Crypt::setMode('ctr');Crypt::setCipher($cipher);

Auth

用户认证

// 判断当前用户是否已认证（是否已登录）Auth::check();// 获取当前的认证用户Auth::user();// 获取当前的认证用户的 ID（未登录情况下会报错）Auth::id();// 通过给定的信息来尝试对用户进行认证（成功后会自动启动会话）Auth::attempt(['email'=>$email,'password'=>$password]);// 通过 Auth::attempt() 传入 true 值来开启 '记住我' 功能Auth::attempt($credentials,true);// 只针对一次的请求来认证用户Auth::once($credentials);// 登录一个指定用户到应用上Auth::login(User::find(1));// 登录指定用户 ID 的用户到应用上Auth::loginUsingId(1);// 使用户退出登录（清除会话）Auth::logout();// 验证用户凭证Auth::validate($credentials);// Attempt to authenticate using HTTP Basic Auth// 使用 HTTP 的基本认证方式来认证Auth::basic('username');// Perform a stateless HTTP Basic login attempt// 执行「HTTP Basic」登录尝试Auth::onceBasic();// 发送密码重置提示给用户Password::remind($credentials,function($message,$user){});

用户授权

// 定义权限Gate::define('update-post','Class@method');Gate::define('update-post',function($user,$post){...});// 传递多个参数Gate::define('delete-comment',function($user,$post,$comment){});// 检查权限Gate::denies('update-post',$post);Gate::allows('update-post',$post);Gate::check('update-post',$post);// 指定用户进行检查Gate::forUser($user)->allows('update-post',$post);// 在 User 模型下，使用 Authorizable traitUser::find(1)->can('update-post',$post);User::find(1)->cannot('update-post',$post);// 拦截所有检查Gate::before(function($user,$ability){});Gate::after(function($user,$ability){});// Blade 模板语法@can('update-post',$post)@endcan// 支持 else 表达式@can('update-post',$post)@else@endcan// 生成一个新的策略php artisan make:policy PostPolicy// `policy` 帮助函数policy($post)->update($user,$post)// 控制器授权$this->authorize('update', $post); // 指定用户 $user 授权$this->authorizeForUser($user, 'update', $post);

Mail

Mail::send('email.view',$data,function($message){});Mail::send(array('html.view','text.view'),$data,$callback);Mail::queue('email.view',$data,function($message){});Mail::queueOn('queue-name','email.view',$data,$callback);Mail::later(5,'email.view',$data,function($message){});// 零时将发送邮件请求写入 log，方便测试Mail::pretend();

消息

// 这些都能在 $message 实例中使用, 并可传入到 Mail::send() 或 Mail::queue()$message->from('email@example.com','Mr. Example');$message->sender('email@example.com','Mr. Example');$message->returnPath('email@example.com');$message->to('email@example.com','Mr. Example');$message->cc('email@example.com','Mr. Example');$message->bcc('email@example.com','Mr. Example');$message->replyTo('email@example.com','Mr. Example');$message->subject('Welcome to the Jungle');$message->priority(2);$message->attach('foo\bar.txt',$options);// 使用内存数据作为附件$message->attachData('bar','Data Name',$options);// 附带文件，并返回 CID$message->embed('foo\bar.txt');$message->embedData('foo','Data Name',$options);// 获取底层的 Swift Message 对象$message->getSwiftMessage();

Queue

Queue::push('SendMail',array('message'=>$message));Queue::push('SendEmail@send',array('message'=>$message));Queue::push(function($job)use$id {});// 在多个 workers 中使用相同的负载Queue::bulk(array('SendEmail','NotifyUser'),$payload);// 开启队列监听器php artisan queue:listen php artisan queue:listen connection php artisan queue:listen --timeout=60// 只处理第一个队列任务php artisan queue:work // 在后台模式启动一个队列 workerphp artisan queue:work --daemon // 为失败的任务创建 migration 文件php artisan queue:failed-table // 监听失败任务php artisan queue:failed // 通过 id 删除失败的任务php artisan queue:forget 5// 删除所有失败任务php artisan queue:flush

Validation

Validator::make(array('key'=>'Foo'),array('key'=>'required|in:Foo'));Validator::extend('foo',function($attribute,$value,$params){});Validator::extend('foo','FooValidator@validate');Validator::resolver(function($translator,$data,$rules,$msgs){returnnewFooValidator($translator,$data,$rules,$msgs);});

Rules

accepted
active_url
after:YYYY-MM-DD before:YYYY-MM-DD alpha alpha_dash alpha_num array between:1,10confirmed date date_format:YYYY-MM-DD different:fieldname digits:value digits_between:min,max booleanemail exists:table,column image in:foo,bar,...not_in:foo,bar,...integer numeric ip max:value min:value mimes:jpeg,png regex:[0-9]required required_if:field,value required_with:foo,bar,...required_with_all:foo,bar,...required_without:foo,bar,...required_without_all:foo,bar,...same:field size:value timezone unique:table,column,except,idColumn url

View

View::make('path/to/view');View::make('foo/bar')->with('key','value');View::make('foo/bar')->withKey('value');View::make('foo/bar',array('key'=>'value'));View::exists('foo/bar');// 跨视图共享变量View::share('key','value');// 视图嵌套View::make('foo/bar')->nest('name','foo/baz',$data);// 注册一个视图构造器View::composer('viewname',function($view){});// 注册多个视图到一个视图构造器中View::composer(array('view1','view2'),function($view){});// 注册一个视图构造器类View::composer('viewname','FooComposer');View::creator('viewname',function($view){});

Blade

// 区块占位@yield('name')// 扩展布局模板@extends('layout.name')// 实现命名为 name 的区块（yield 占位的地方）@section('name')@stop// 可继承内容区块@section('sidebar')@show// 继承父模板内容（@show 的区块内容）@parent// 包含子视图@include('view.name')// 包含子视图，并传参@include('view.name',array('key'=>'value'));// 加载本地化语句@lang('messages.name')@choice('messages.name',1);@if@else@elseif@endif@unless@endunless@for@endfor@foreach@endforeach@while@endwhile//forelse 4.2 feature@forelse($users as$user)@empty@endforelse// 输出内容，被转义过的{{$var }}// 输出未转义内容，5.0 特性{!!$var !!}{{--Blade注释，不会被输出到页面中--}}// 三元表达式的简写，以下相当于「$name ? $name : 'Default'」{{{$name or'Default'}}}// 保留双大括号，以下会编译为 {{ name }}@{{name }}

Form

Form::open(array('url'=>'foo/bar','method'=>'PUT'));Form::open(array('route'=>'foo.bar'));Form::open(array('route'=>array('foo.bar',$parameter)));Form::open(array('action'=>'FooController@method'));Form::open(array('action'=>array('FooController@method',$parameter)));Form::open(array('url'=>'foo/bar','files'=>true));Form::close();Form::token();Form::model($foo,array('route'=>array('foo.bar',$foo->bar)));

Form Elements

Form::label('id','Description');Form::label('id','Description',array('class'=>'foo'));Form::text('name');Form::text('name',$value);Form::text('name',$value,array('class'=>'name'));Form::textarea('name');Form::textarea('name',$value);Form::textarea('name',$value,array('class'=>'name'));Form::hidden('foo',$value);Form::password('password');Form::password('password',array('placeholder'=>'Password'));Form::email('name',$value,array());Form::file('name',array('class'=>'name'));Form::checkbox('name','value');// 生成一个被选中的复选框Form::checkbox('name','value',true,array('class'=>'name'));Form::radio('name','value');// 生成一个被选中的单选框Form::radio('name', 'value', true, array('class' => 'name')); Form::select('name', array('key' => 'value')); Form::select('name', array('key' => 'value'), 'key', array('class' => 'name')); Form::selectRange('range', 1, 10); Form::selectYear('year', 2011, 2015); Form::selectMonth('month'); Form::submit('Submit!', array('class' => 'name')); Form::button('name', array('class' => 'name')); Form::macro('fooField', function() { return '<input type="custom"/>'; }); Form::fooField();

HTML

HTML::macro('name',function(){});// 将 HTML 字符串转为实体HTML::entities($value);// 将实体转为 HTML 字符HTML::decode($value);// 生成 JavaScript 文件链接HTML::script($url,$attributes);// 生成 CSS 文件链接HTML::style($url,$attributes);// 生成一个 HTML 图片元素HTML::image($url,$alt,$attributes);// 生成一个 HTML 链接HTML::link($url,'title',$attributes,$secure);// 生成一个 HTTPS 类型的 HTML 链接HTML::secureLink($url,'title',$attributes);// 给资源文件生成一个 HTML linkHTML::linkAsset($url,'title',$attributes,$secure);// 给资源文件生成一个 HTTPS HTML 链接HTML::linkSecureAsset($url,'title',$attributes);// 给命名路由生成一个 HTML 链接HTML::linkRoute($name,'title',$parameters,$attributes);// 给控制器动作生成 HTML 链接HTML::linkAction($action,'title',$parameters,$attributes);// 给邮件地址生成 HTML 链接HTML::mailto($email,'title',$attributes);// 混淆一个邮件地址以阻止垃圾邮件扫描器的嗅探HTML::email($email);// 生成有序列表HTML::ol($list,$attributes);// 生成无序列表HTML::ul($list,$attributes);HTML::listing($type,$list,$attributes);HTML::listingElement($key, $type, $value); HTML::nestedListing($key, $type, $value); // 从数组中构建 HTML 属性HTML::attributes($attributes); // 构建单属性元素HTML::attributeElement($key, $value); // 混淆一个字符串以阻止垃圾邮件扫描器的嗅探HTML::obfuscate($value);

String

// 将 UTF-8 的值直译为 ASCII 类型的值Str::ascii($value)Str::camel($value)Str::contains($haystack,$needle)Str::endsWith($haystack,$needles)Str::finish($value,$cap)Str::is($pattern,$value)Str::length($value)Str::limit($value,$limit =100,$end ='...')Str::lower($value)Str::words($value,$words =100,$end ='...')Str::plural($value,$count =2)// 生成更加真实的 "随机" 字母数字字符串.Str::random($length =16)// 生成一个 "随机" 字母数字字符串.Str::quickRandom($length =16)Str::upper($value)Str::title($value)Str::singular($value)Str::slug($title,$separator ='-')Str::snake($value,$delimiter ='_')Str::startsWith($haystack,$needles)Str::studly($value)Str::macro($name, $macro)

Helper

数组

// 如果给定的键不存在于该数组，array_add 函数将给定的键值对加到数组中array_add($array,'key','value');// 将数组的每一个数组折成单一数组array_collapse($array);// 函数返回两个数组，一个包含原本数组的键，另一个包含原本数组的值array_divide($array);// 把多维数组扁平化成一维数组，并用「点」式语法表示深度array_dot($array);// 从数组移除给定的键值对array_except($array,array('key'));// 返回数组中第一个通过为真测试的元素array_first($array,function($key,$value){},$default);// 将多维数组扁平化成一维// ['Joe', 'PHP', 'Ruby'];array_flatten(['name'=>'Joe','languages'=>['PHP','Ruby']]);// 以「点」式语法从深度嵌套数组移除给定的键值对array_forget($array,'foo');array_forget($array,'foo.bar');// 使用「点」式语法从深度嵌套数组取回给定的值array_get($array,'foo','default');array_get($array,'foo.bar','default');// 使用「点」式语法检查给定的项目是否存在于数组中array_has($array,'products.desk');// 从数组返回给定的键值对array_only($array,array('key'));// 从数组拉出一列给定的键值对array_pluck($array,'key');// 从数组移除并返回给定的键值对array_pull($array,'key');// 使用「点」式语法在深度嵌套数组中写入值array_set($array,'key','value');array_set($array,'key.subkey','value');// 借由给定闭包结果排序数组array_sort($array,function(){});// 使用 sort 函数递归排序数组array_sort_recursive();// 使用给定的闭包过滤数组array_where();// 返回给定数组的第一个元素head($array);// 返回给定数组的最后一个元素last($array);

路径

// 取得 app 文件夹的完整路径app_path();// 取得项目根目录的完整路径base_path();// 取得应用配置目录的完整路径config_path();// 取得应用数据库目录的完整路径database_path();// 取得加上版本号的 Elixir 文件路径elixir();// 取得 public 目录的完整路径public_path();// 取得 storage 目录的完整路径storage_path();

字符串

// 将给定的字符串转换成 驼峰式命名camel_case($value);// 返回不包含命名空间的类名称class_basename($class);class_basename($object);// 对给定字符串运行 htmlentitiese('<html>');// 判断字符串开头是否为给定内容starts_with('Foo bar.','Foo');// 判断给定字符串结尾是否为指定内容ends_with('Foo bar.','bar.');// 将给定的字符串转换成 蛇形命名snake_case('fooBar');// 限制字符串的字符数量str_limit();// 判断给定字符串是否包含指定内容str_contains('Hello foo bar.','foo');// 添加给定内容到字符串结尾，foo/bar/str_finish('foo/bar','/');// 判断给定的字符串与给定的格式是否符合str_is('foo*','foobar');// 转换字符串成复数形str_plural('car');// 产生给定长度的随机字符串str_random(25);// 转换字符串成单数形。该函数目前仅支持英文str_singular('cars');// 从给定字符串产生网址友善的「slug」str_slug("Laravel 5 Framework","-");// 将给定字符串转换成「首字大写命名」: FooBarstudly_case('foo_bar');// 根据你的本地化文件翻译给定的语句trans('foo.bar');// 根据后缀变化翻译给定的语句trans_choice('foo.bar',$count);

URLs and Links

// 产生给定控制器行为网址action('FooController@method',$parameters);// 根据目前请求的协定（HTTP 或 HTTPS）产生资源文件网址asset('img/photo.jpg',$title,$attributes);// 根据 HTTPS 产生资源文件网址secure_asset('img/photo.jpg',$title,$attributes);// 产生给定路由名称网址route($route,$parameters,$absolute =true);// 产生给定路径的完整网址url('path',$parameters =array(),$secure =null);

Miscellaneous

// 返回一个认证器实例。你可以使用它取代 Auth facadeauth()->user();// 产生一个重定向回应让用户回到之前的位置back();// 使用 Bcrypt 哈希给定的数值。你可以使用它替代 Hash facadebcrypt('my-secret-password');// 从给定的项目产生集合实例collect(['taylor','abigail']);// 取得设置选项的设置值config('app.timezone',$default);// 产生包含 CSRF 令牌内容的 HTML 表单隐藏字段{!!csrf_field()!!}// 取得当前 CSRF 令牌的内容$token =csrf_token();// 输出给定变量并结束脚本运行dd($value);// 取得环境变量值或返回默认值$env =env('APP_ENV');$env =env('APP_ENV','production');// 配送给定事件到所属的侦听器event(newUserRegistered($user));// 根据给定类、名称以及总数产生模型工厂建构器$user =factory(App\User::class)->make();// 产生拟造 HTTP 表单动作内容的 HTML 表单隐藏字段{!!method_field('delete')!!}// 取得快闪到 session 的旧有输入数值$value =old('value');$value =old('value','default');// 返回重定向器实例以进行 重定向returnredirect('/home');// 取得目前的请求实例或输入的项目$value =request('key',$default =null)// 创建一个回应实例或获取一个回应工厂实例returnresponse('Hello World',200,$headers);// 可被用于取得或设置单一 session 内容$value =session('key');// 在没有传递参数时，将返回 session 实例$value =session()->get('key');session()->put('key',$value);// 返回给定数值value(function(){return'bar';});// 取得视图 实例returnview('auth.login'); // 返回给定的数值$value = with(new Foo)->work();

Collection

// 创建集合collect([1,2,3]);// 返回该集合所代表的底层数组：$collection->all();// 返回集合中所有项目的平均值：$collection->avg();// 将集合拆成多个给定大小的较小集合：$collection->chunk(4);// 将多个数组组成的集合折成单一数组集合：$collection->collapse();// 用来判断该集合是否含有指定的项目：$collection->contains('New York');// 返回该集合内的项目总数：$collection->count();// 遍历集合中的项目，并将之传入给定的回调函数：$collection =$collection->each(function($item,$key){});// 会创建一个包含第 n 个元素的新集合：$collection->every(4);// 传递偏移值作为第二个参数：$collection->every(4,1);// 返回集合中排除指定键的所有项目：$collection->except(['price','discount']);// 以给定的回调函数筛选集合，只留下那些通过判断测试的项目：$filtered =$collection->filter(function($item){return$item >2;});// 返回集合中，第一个通过给定测试的元素：collect([1,2,3,4])->first(function($key,$value){return$value >2;});// 将多维集合转为一维集合：$flattened =$collection->flatten();// 将集合中的键和对应的数值进行互换：$flipped =$collection->flip();// 以键自集合移除掉一个项目：$collection->forget('name');// 返回含有可以用来在给定页码显示项目的新集合：$chunk =$collection->forPage(2,3);// 返回给定键的项目。如果该键不存在，则返回 null：$value = $collection->get('name'); // 根据给定的键替集合内的项目分组：$grouped = $collection->groupBy('account_id'); // 用来确认集合中是否含有给定的键：$collection->has('email'); // 用来连接集合中的项目$collection->implode('product', ', '); // 移除任何给定数组或集合内所没有的数值：$intersect = $collection->intersect(['Desk', 'Chair', 'Bookcase']); // 假如集合是空的，isEmpty 方法会返回 true：collect([])->isEmpty(); // 以给定键的值作为集合项目的键：$keyed = $collection->keyBy('product_id'); // 传入回调函数，该函数会返回集合的键的值：$keyed = $collection->keyBy(function ($item) { return strtoupper($item['product_id']); }); // 返回该集合所有的键：$keys = $collection->keys(); // 返回集合中，最后一个通过给定测试的元素：$collection->last(); // 遍历整个集合并将每一个数值传入给定的回调函数：$multiplied = $collection->map(function ($item, $key) { return $item * 2; }); // 返回给定键的最大值：$max = collect([['foo' => 10], ['foo' => 20]])->max('foo'); $max = collect([1, 2, 3, 4, 5])->max(); // 将给定的数组合并进集合：$merged = $collection->merge(['price' => 100, 'discount' => false]); // 返回给定键的最小值：$min = collect([['foo' => 10], ['foo' => 20]])->min('foo'); $min = collect([1, 2, 3, 4, 5])->min(); // 返回集合中指定键的所有项目：$filtered = $collection->only(['product_id', 'name']); // 获取所有集合中给定键的值：$plucked = $collection->pluck('name'); // 移除并返回集合最后一个项目：$collection->pop(); // 在集合前面增加一个项目：$collection->prepend(0); // 传递第二个参数来设置前置项目的键：$collection->prepend(0, 'zero'); // 以键从集合中移除并返回一个项目：$collection->pull('name'); // 附加一个项目到集合后面：$collection->push(5); // put 在集合内设置一个给定键和数值：$collection->put('price', 100); // 从集合中随机返回一个项目：$collection->random(); // 传入一个整数到 random。如果该整数大于 1，则会返回一个集合：$random = $collection->random(3); // 会将每次迭代的结果传入到下一次迭代：$total = $collection->reduce(function ($carry, $item) { return $carry + $item; }); // 以给定的回调函数筛选集合：$filtered = $collection->reject(function ($item) { return $item > 2; }); // 反转集合内项目的顺序：$reversed = $collection->reverse(); // 在集合内搜索给定的数值并返回找到的键：$collection->search(4); // 移除并返回集合的第一个项目：$collection->shift(); // 随机排序集合的项目：$shuffled = $collection->shuffle(); // 返回集合从给定索引开始的一部分切片：$slice = $collection->slice(4); // 对集合排序：$sorted = $collection->sort(); // 以给定的键排序集合：$sorted = $collection->sortBy('price'); // 移除并返回从指定的索引开始的一小切片项目：$chunk = $collection->splice(2); // 返回集合内所有项目的总和：collect([1, 2, 3, 4, 5])->sum(); // 返回有着指定数量项目的集合：$chunk = $collection->take(3); // 将集合转换成纯 PHP 数组：$collection->toArray(); // 将集合转换成 JSON：$collection->toJson(); // 遍历集合并对集合内每一个项目调用给定的回调函数：$collection->transform(function ($item, $key) { return $item * 2; }); // 返回集合中所有唯一的项目：$unique = $collection->unique(); // 返回键重设为连续整数的的新集合：$values = $collection->values(); // 以一对给定的键／数值筛选集合：$filtered = $collection->where('price', 100); // 将集合与给定数组同样索引的值合并在一起：$zipped = $collection->zip([100, 200]);