本文以laravel5.0.22为例。
生产环境建议使用版本,因为该版本是长期支持版本。5.1文档更详细:http://laravel-china.org/docs/5.1。
环境需求
Laravel5.0 框架有一些系统上的需求:
PHP 版本 >= 5.4
Mcrypt PHP 扩展 OpenSSL PHP 扩展 Mbstring PHP 扩展 Tokenizer PHP 扩展
在 PHP 5.5 之后, 有些操作系统需要手动安装 PHP JSON 扩展包。如果你是使用 Ubuntu,可以通过 apt-get install php5-json 来进行安装。
我该使用Laravel吗
来自知乎网友的讨论:PHP框架Laravel还是Codeigniter? https://www.zhihu.com/question/21617669
CI比较接近原生的PHP,在原有PHP代码的基础上封装了很多类,因为它架构简单,所以容易扩展。从另一个角度来看,也就是没啥架构,最最原始的三层架构。
Laravel 简直就是一次创新,大量吸收了Java,RoR等其他框架的精华,在架构方面,已基本做到现有Php框架最佳,扩展性,伸缩性强大得一塌糊涂,非常适合团队作战。
对于新手来说,Laravel初看上去不太像Php的原本写法了,所谓优雅,就是你光凭代码就可以知道意思,而不用读注释,代码精简复用度非常高;Laravel开发人员都是PHP圈子最顶尖的高手,他们习惯用新的技术和架构,即便如此,Laravel其实上手并不难,一旦以你掌握了它的大致要点后,你会逐渐发现它在每一个方面都全面超越CI,且实用性非常高。(来源:知乎)
简单建议:
如果是个人项目,旨在研究,推荐Laravel;如果是外包或者公司项目,推荐Codeigniter或者ThinkPHP。
特点
RESTful Routing ;
设计精妙的 Blade 模板引擎, 轻快, 不失灵活 ; 合理的 ORM model 层, Eloquent ORM , 借鉴于 Rails 的成功; migration 数据库版本系统 和 seeding ; 使用包管理器 Composer , 打开了一扇开往春天的门; 强调测试驱动, 整个核心经受过完整的测试, 高质量的代码; 命令行驱动, 可以做到高度自动化 (讲究效率, 代码生成器...) , 借鉴与 rails ; 合理使用 PHP 的新版本特性, 让写代码更加有乐趣, 跟上时代的步伐; 积极向上的社区, 这个很重要呀, 大家都在学习着, 创造着好的工具, 加快开发速度, 提高编程效率, 接受新知识的速度也很快. 对 php 标准化的支持 PHP-FIG — PHP Framework Interop Group
更多阅读:
1、最好的 PHP 框架是什么?为什么? - Charlie Jade 的回答 - 知乎 https://www.zhihu.com/question/19558755/answer/230621102、php - Laravel框架相对于其他框架比如CI、TP、Symfony等的优势是什么? - SegmentFault
https://segmentfault.com/q/1010000000489103安装
使用Composer安装
很多人会卡在这一步。要么是不会Composer,要么就是无法使用Composer安装。
如果还不知道Composer,先去学习了解了解:
1、Composer使用 - 飞鸿影~ - 博客园
http://www.cnblogs.com/52fhy/p/5246013.html 2、Packagist / Composer 中国全量镜像 http://pkg.phpcomposer.com/ 3、Composer 中文网 http://www.phpcomposer.com/
如果无法使用用Composer安装,很有可能是仓库访问不了,即被墙了。先更新Composer仓库源:
# 修改 composer 的全局配置文件(推荐方式)# 打开命令行窗口(windows用户)或控制台(Linux、Mac 用户)并执行如下命令:composer config -g repo.packagist composer https://packagist.phpcomposer.com
接下来正式开始安装吧!
这里以Laravel 5.0 版本为例(PHP 版本>=
5.4)。 # 指定5.0.22版本,项目目录是learnlaravel5composer create-project laravel/laravel learnlaravel5 5.0.22
等待安装(需要5分钟左右):
Installing laravel/laravel (v5.0.22) - Installing laravel/laravel (v5.0.22) Downloading: 100%Created project in learnlaravel5Loading composer repositories with package informationInstalling dependencies (including require-dev) from lock file - Installing jakub-onderka/php-console-color (0.1) Downloading: 100% - Installing vlucas/phpdotenv (v1.1.0) Downloading: 100% - Installing symfony/var-dumper (v2.6.4) Downloading: 100% - Installing symfony/translation (v2.6.4) Downloading: 100% - Installing symfony/security-core (v2.6.4) Downloading: 100% - Installing symfony/routing (v2.6.4) Downloading: 100% - Installing symfony/process (v2.6.4) Downloading: 100% - Installing symfony/http-foundation (v2.6.4) Downloading: 100% - Installing symfony/event-dispatcher (v2.6.4) Downloading: 100% - Installing psr/log (1.0.0) Downloading: 100%...Generating autoload files> php artisan clear-compiled> php artisan optimizeGenerating optimized class loaderCompiling common classes> php -r "copy('.env.example', '.env');"> php artisan key:generateApplication key [4FunRLeVWE0jc6QTs3h8vNbDnoa4Qi8Q] set successfully.
安装完便可以访问了:
http://localhost/laravel5/public/index.php
一键安装包下载
一键安装包是在 Laravel 官方 GitHub 仓库源码的基础上安装了依赖库(也就是已经做过 composer install,已经有了 vendor 目录),对于刚接触 Laravel 或者使用 Composer 受挫的用户能够提供快速上手实践 Laravel 的捷径。
Laravel 一键安装包。更新时间:2016年3月7日下午3点04分
master 7.45M http://down.golaravel.com/laravel/laravel-master.zip
v5.2.15 7.46M http://down.golaravel.com/laravel/laravel-v5.2.15.zip v5.1.11 7.97M http://down.golaravel.com/laravel/laravel-v5.1.11.zip v5.0.22 5.94M http://down.golaravel.com/laravel/laravel-v5.0.22.zip v4.2.11 5.06M http://down.golaravel.com/laravel/laravel-v4.2.11.zip v4.1.27 4.60M http://down.golaravel.com/laravel/laravel-v4.1.27.zip v4.0.9 6.05M http://down.golaravel.com/laravel/laravel-v4.0.9.zip来源:http://www.golaravel.com/download/
项目结构
app|---Commands|---Console|---Events|---Exceptions|---Handlers|---Http |---Controllers 控制器 |---Middleware 中间件 |---Requests 请求 |---routes.php 路由|---Providers|---Services|---User.php 模型文件bootstrapconfigdatabasepublicresources|---lang|---views 视图 |---welcome.blade.php |---home.blade.phpstorage|---logstestsvendor.envartisancomposer.jsonserver.php
Laravel 框架有一个目录需要额外配置权限:storage
和 vendor
目录要让服务器有写入的权限。
路由(Route)
路由文件在:app/Http/routes.php
。
默认的配置:
Route::get('/', 'WelcomeController@index');//匹配根目录到WelcomeController/indexRoute::get('home', 'HomeController@index');//匹配home到HomeController/indexRoute::controller('blog', 'BlogController');//匹配BlogController里的所有方法,但控制器里方法必须以get、post开头//路由组Route::controllers([ 'auth' => 'Auth\AuthController', 'password' => 'Auth\PasswordController',]);
控制器(Controllers)
控制器路径:app/Http/Controllers
。
继承自根控制器:Controller.php
生成url
url()方法可以生成符合规范的url。
echo url('greeting');//输出:http://localhost/laravel5/public/index.php/greeting
配置
配置文件:.env
,包含了数据库和MAIL等配置。
config
目录下也有相关配置。 模型(Model)
与Laravel4系列不同,旧的 app/models
目录已经完全被移除。相对的,Laravel5模型文件都放在 app
目录下,以及默认使用 App
命名空间。
示例:Blog.php
all(); }}
视图(views)
视图根路径:resources/views
。
视图与控制器对应关系:
例如:控制器里view('welcome'); //对应视图根路径下welcome.blade.phpview('admin.pages.edit', $data); //对应对应视图根路径下admin/pages/edit.blade.php
视图文件代码上实际就是html。但自定义了一些标签。
在视图文件,我们可以使用PHP原生语法来获取传过来的数据:
Hello,
或者使用Laravel的Blade模板标签:双大括号:
Hello, { {$name}}
控制器(WelcomeController.php)里是这样的:
public function greeting() { return view('greeting', ['name' => 'James']);}
注意,测试的时候要新建路由:
Route::get('greeting', 'WelcomeController@greeting');
访问:http://localhost/laravel5/public/index.php/greeting
传递数据到视图
// 使用传统的方法$view = view('greeting')->with('name', 'Victoria');// 使用魔术方法$view = view('greeting')->withName('Victoria');
模板标签语言
示例文件:
layout.blade.php 母视图Laravel Quickstart
@yield('content')
users.blade.php 普通视图
@extends('layout')@section('content') Users!@endsection
1、输出:使用双花括号: { {$name}}
。
@extends
,将copy一份母视图过来。 引入:@include('shared.errors')
引入子视图 3、区域替换:@section
...@endsection
,该标签内的内容将替换在母视图使用@yield
定义的内容。 4、条件语句:@if
...@endif
。 @if (count($records) === 1) 我有一条记录!@elseif (count($records) > 1) 我有多条记录!@else 我没有任何记录!@endif
5、数据遍历、循环:
@for ($i = 0; $i < 10; $i++) 目前的值为 { { $i }}@endfor@foreach ($users as $user)此用户为 {
{ $user->id }}@endforeach@forelse ($users as $user)
没有用户
@endforelse@while (true)我永远都在跑循环。
@endwhile6、url生成:示例
{ { url('blog/detail/'.$item->id) }}# 或者{ { url('blog/detail',array('id'=>$item->id)) }}
控制器里方法括号里接这个参数:
public function getDetail($id){ $blog = new Blog(); $detail = $blog->find($id); return view('detail', array( 'detail' => $detail )); }
7、public目录下资源引用
{ {asset('/css/main.css')}}
对应public目录下的css/main.css
8、视图可以显示PHP 函数的结果。实际上,可以放置任何想要的 PHP 代码到 Blade 显示的语法里面:目前的 UNIX 时间戳为 { { time() }}。
9、禁用渲染
由于许多 JavaScript 框架也使用「大括号」在浏览器中显示指定的表达式,因此可以使用@
符号来告知 Blade 渲染引擎该表达式应该维持原样。举个例子: Hello, @{ { name }}.
10、缺省值:
{ { isset($name) ? $name : 'Default' }}# 或者{ { $name or 'Default' }}
11、显示未转义过的数据
默认输出的值会自动调用 PHP 的 htmlentities 函数,以避免 XSS 攻击。禁用:Hello, {!! $name !!}.
参考:Laravel 5.1 中文文档:Blade 模板
http://laravel-china.org/docs/5.1/blade
数据库操作
Laravel中提供DB facade、查询构造器和Eloquent ORM三种数据库操作方式。本文接下来将讲解前两种方式。
数据库相关配置文件都在 config/database.php
。默认从.env
文件中读取配置。
目前 Laravel 支持四种数据库系统: MySQL、Postgres、SQLite、以及 SQL Server。
读写分离:
'mysql' => [ 'read' => [ 'host' => '192.168.1.1', ], 'write' => [ 'host' => '196.168.1.2' ], 'driver' => 'mysql', 'database' => 'database', 'username' => 'root', 'password' => '', 'charset' => 'utf8', 'collation' => 'utf8_unicode_ci', 'prefix' => '',],
使用DB类进行CURD
需要先引入。
use Illuminate\Support\Facades\DB;
例如:
public function greeting() { $results = DB::select('select * from blog where id = ?', [1]); print_r($results);exit;}
输出:
Array ( [0] => stdClass Object ( [id] => 1 [uid] => 1 [title] => test [content] => hello laravel5! [flag] => 1 [create_time] => 0 [update_time] => 0 ) )
更多方法(来自):
//执行 Select 查找$results = DB::select('select * from users where id = ?', [1]);$results = DB::select('select * from users where id = :id', ['id' => 1]);//执行 Insert 语法DB::insert('insert into users (id, name) values (?, ?)', [1, 'Dayle']);//执行 Update 语法DB::update('update users set votes = 100 where name = ?', ['John']);执行 Delete 语法DB::delete('delete from users');//执行一般语法DB::statement('drop table users');//监听查找事件DB::listen(function($sql, $bindings, $time){ //});//数据库事务处理//你可以使用 transaction 方法,去执行一组数据库事务处理的操作:DB::transaction(function(){ DB::table('users')->update(['votes' => 1]); DB::table('posts')->delete();});//手动事务DB::beginTransaction();DB::rollback();DB::commit();//获取连接//若要使用多个连接,可以通过 DB::connection 方法取用:$users = DB::connection('foo')->select(...);//你也可以取用原始底层的 PDO 实例:$pdo = DB::connection()->getPdo();//有时候你可能需要重新连接到特定的数据库:DB::reconnect('foo');//如果你因为超过了底层 PDO 实例的 max_connections 的限制,需要关闭特定的数据库连接,可以通过 disconnect 方法:DB::disconnect('foo');//查找日志记录//Laravel 可以在内存里访问这次请求中所有的查找语句。然而在有些例子下要注意,比如一次添加 大量的数据,可能会导致应用程序耗损过多内存。 如果要启用日志,可以使用 enableQueryLog 方法:DB::connection()->enableQueryLog();//要得到执行过的查找纪录数组,你可以使用 getQueryLog 方法:$queries = DB::getQueryLog();
DB类查询构造器
Laravel 查询构造器使用 PDO 参数绑定,以保护应用程序免于 SQL 注入,因此传入的参数不需额外转义特殊字符。
示例:
//获取所有数据列$users = DB::table('users')->get();
查询:
//根据条件查找,取得单一数据列$user = DB::table('users')->where('name', 'John')->first();var_dump($user->name);//从数据表中取得单一数据列的单一字段$name = DB::table('users')->where('name', 'John')->pluck('name');//取得单一字段值的列表:这个方法将会返回数据表 role 的 title 字段值的数组$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();//or$users = DB::table('users') ->where('votes', '>', 100) ->orWhere('name', 'John') ->get(); //Between$users = DB::table('users') ->whereBetween('votes', [1, 100])->get(); //Not Between$users = DB::table('users') ->whereNotBetween('votes', [1, 100])->get(); //In$users = DB::table('users') ->whereIn('id', [1, 2, 3])->get();//NotIn$users = DB::table('users') ->whereNotIn('id', [1, 2, 3])->get(); //Null 找有未配置的值的数据$users = DB::table('users') ->whereNull('updated_at')->get();//魔术语句 $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(); //偏移(Offset) 及 限制(Limit)$users = DB::table('users')->skip(10)->take(5)->get();//基本的 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(); //更高级的 join 子句:DB::table('users') ->join('contacts', function($join) { $join->on('users.id', '=', 'contacts.user_id')->orOn(...); }) ->get(); DB::table('users') ->join('contacts', function($join) { $join->on('users.id', '=', 'contacts.user_id') ->where('contacts.user_id', '>', 5); }) ->get(); //群组化参数DB::table('users') ->where('name', '=', 'John') ->orWhere(function($query) { $query->where('votes', '>', 100) ->where('title', '<>', 'Admin'); }) ->get(); //上面的查找语法会产生下方的 SQL:select * from users where name = 'John' or (votes > 100 and title <> 'Admin')//Exists 语法DB::table('users') ->whereExists(function($query) { $query->select(DB::raw(1)) ->from('orders') ->whereRaw('orders.user_id = users.id'); }) ->get();//上面的查找语法会产生下方的 SQL:select * from userswhere exists ( select 1 from orders where orders.user_id = users.id)//使用聚合方法$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');
新增:
//新增,不会返回新增IDDB::table('users')->insert( ['email' => 'john@example.com', 'votes' => 0]);//新增,返回新增ID$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();
更多查看:http://laravel-china.org/docs/5.0/queries
Eloquent ORM
相比DB类,Laravel 的 Eloquent ORM 提供优雅的 ActiveRecord 实现来和数据库的互动。 每个数据库表会有一个对应的模型文件。
详见下一章。学习资料
推荐教程:
Laravel 5 系列入门教程(一)【最适合中国人的 Laravel 教程】 - 岁寒 https://lvwenhan.com/laravel/432.htmlLaravel 5 中文文档:
- http://laravel-china.org/docs/5.0
- http://laravel-china.org/docs/5.1
- http://www.golaravel.com/laravel/docs/5.0/
更多:
Laravist |Laravel Vuejs Bootstrap 视频教程
https://laravist.com/LaraBase——全栈工程师之家
http://laravelbase.com/Laravel - The PHP Framework For Web Artisans
http://laravel.com/laravel/laravel
https://github.com/laravel/laravel