本文介绍如何开始使用 laravel,对于laravel来说是去年到今年最流行的框架。很多php高手,在写项目的时候,非常喜欢laravel。因为laravel可以让项目更快的速度去实现,去部署。并且使用起来非常简单。 在这里我们推荐学习和使用laravel,php学院推荐在学习la
本文介绍如何开始使用 laravel,对于laravel来说是去年到今年最流行的框架。很多php高手,在写项目的时候,非常喜欢laravel。因为laravel可以让项目更快的速度去实现,去部署。并且使用起来非常简单。
在这里我们推荐学习和使用laravel,php学院推荐在学习laravel过程中可以多多动手。读完本文,你将学到:
如何安装 laravel,新建 laravel 程序,如何连接数据库;laravel 程序的基本文件结构;mvc(模型,视图,控制器)和 rest 架构的基本原理;如何快速生成 laravel 程序骨架;1 前提条件本文针对想从零开始开发 laravel 程序的初学者,不需要预先具备任何的 laravel 使用经验。不过,为了能顺利阅读,还是需要事先安装好一些软件:
php 5.4 及以上版本包管理工具 composer 。想深入了解 composer,请阅读 composer 指南 。官网:https://getcomposer.org/ , 中文网 :http://www.phpcomposer.com/sqlite3 数据库laravel 是使用 php 语言开发的网页程序框架。如果之前没接触过 php,学习 laravel 可要深下一番功夫。网上有很多资源可以学习 php:
php 语言官方网站: http://php.net/
2 laravel 是什么?laravel 是使用 php 语言编写的网页程序开发框架,目的是为开发者提供常用组件,简化网页程序的开发。只需编写较少的代码,就能实现其他编程语言或框架难以企及的功能。经验丰富的 php 程序员会发现,laravel 让程序开发变得更有乐趣。
laravel 哲学laravel 是一套富有表达性且具有简洁语法的网页应用程序框架。我们认为开发过程应该是愉悦且有创造性的体验。laravel 努力减少开发过程中的不便,因此我们提供了验证(authentication)、路由(routing)、sessions、缓存(caching)等开发过程中经常用到的工具或功能。laravel 目标是给开发者创造一个愉快的开发过程,并且不牺牲应用程序的功能性。快乐的开发者才能创造最棒的代码。为了这个目的,我们竭取了各框架的优点集中到 laravel 中,这些框架包括并不局限于 ruby on rails、asp.net mvc 和 sinatra 等。laravel 是易于理解且强大的,它提供了强大的工具来开发大型、稳健的应用程序。杰出的 ioc、数据库迁移工具和紧密集成的单元测试,这些工具赋予您构建任何大小规模的应用程序的能力。3 新建 laravel 程序阅读本文时,最好跟着一步一步操作,如果错过某段代码或某个步骤,程序就可能出错,所以请一步一步跟着做。
本文会新建一个名为 blog 的 laravel 程序,这是一个非常简单的博客。
文中的示例代码使用 $ 表示命令行提示符,你的提示符可能修改过,所以会不一样。在 windows 中,提示符可能是 c:\source_code>。
3.1 安装 laravel打开命令行:在 mac os x 中打开 terminal.app,在 windows 中选择“运行”,然后输入“cmd.exe”。下文中所有以 $ 开头的代码,都要在命令行中运行。先确认是否安装了 php 5.4 或者以上的版本:
有很多工具可以帮助你快速在系统中安装 php 。windows 用户可以使用 wamp,mac os x 用户可以使用 mamp。
$ php -v php 5.4.10 (cli) (built: jan 21 2013 15:12:32) copyright (c) 1997-2012 the php group zend engine v2.4.0, copyright (c) 1998-2012 zend technologies with xcache v2.0.1, copyright (c) 2005-2012, by moo
如果你还没安装 php,请访问 http://php.net/ ,找到针对所用系统的安装方法。
很多类 unix 系统都自带了版本尚新的 sqlite3。windows 等其他操作系统的用户可以在 sqlite3 的网站上找到安装说明。然后,确认是否在 path 中:
$ sqlite3 --version
安装 laravel , 通过 laravel 安装器
首先, 使用 composer 全局下载并安装 laravel/installer:
$ composer global require laravel/installer=~1.1
请确定把 ~/.composer/vendor/bin 路径放置于您的 path 里, 这样laravel 可执行文件才能被命令行找到, 以后您就可以在命令行下直接使用 laravel 命令.
安装并且配置成功后, 可以使用命令 laravel new 在您指定的目录下创建一份全新安装的 laravel 应用, 如这样的调用:laravel new blog 将会在当前目录下创建一个叫 blog 的目录, 此目录里面存放着全新安装的 laravel 应用, 此方法跟其他方法不一样的地方在于是提前安装好所有代码依赖的, 您无需再通过composer install 安装, 速度一下子提高了很多.
laravel 框架使用 composer 来执行安装及管理依赖。如果还没有安装它的话,请先从 安装 composer 开始吧。
安装之后,您可以通过终端执行下列命令来安装 laravel:
$ composer create-project laravel/laravel your-project-name --prefer-dist
这个命令会下载并安装一份全新的 laravel 存放在指定的 your-project-name 的目录中。
如果您想要手动安装 laravel 可以直接从 github 上的 laravel respoitory下载一份代码。然后在解压后的根目录里,执行 composer install 即可,这个命令会把框架所需要的依赖下载完整。
3.2 创建 blog 程序artisan 是 laravel 内建的命令行工具,它提供了一些有用的命令协助您开发,它是由强大的 symfony console 组件所驱动。
打开终端,进入有写权限的文件夹,执行以下命令生成一个新程序:
$ laravel new blog
或者
$ composer create-project laravel/laravel blog --prefer-dist
这个命令会在文件夹 blog 中新建一个 laravel 程序。
执行 laravel new -h 可以查看新程序生成器的所有命令行选项。
生成 blog 程序后,进入该文件夹:
$ cd blog
blog 文件夹中有很多自动生成的文件和文件夹,组成一个 laravel 程序。本文大部分时间都花在 app 文件夹上。下面简单介绍默认生成的文件和文件夹的作用:
文件/文件夹作用
app/ 包含了站点的 controllers(控制器),models(模型),views(视图)和 assets(资源)。这些是网站运行的主要代码,你会将你大部分的时间花在这些上面。本文主要关注的是这个文件夹。
bootstrap 用来存放系统启动时需要的文件,这些文件会被如 index.php 这样的文件调用。
public 这个文件夹是唯一外界可以看到的,是必须指向你 web 服务器的目录。它含有 laravel 框架核心的引导文件 index.php,这个目录也可用来存放任何可以公开的静态资源,如 css,javascript,images 等。
vendor 用来存放所有的第三方代码,在一个典型的 laravel 应用程序,这包括 laravel 源代码及其相关,并含有额外的预包装功能的插件。
app/config/ 配置应用程序的运行时规则、 数据库、 session等等。包含大量的用来更改框架的各个方面的配置文件。大部分的配置文件中返回的选项关联php数组。
app/config/app.php 各种应用程序级设置,即时区、 区域设置(语言环境)、 调试模式和独特的加密密钥。
app/config/auth.php 控制在应用程序中如何进行身份验证,即身份验证驱动程序。
app/config/cache.php 如果应用程序利用缓存来加快响应时间,要在此配置该功能。
app/config/compile.php 在此处可以指定一些额外类,去包含由‘artisan optimize’命令声称的编译文件。这些应该是被包括在基本上每个请求到应用程序中的类。
app/config/database.php 包含数据库的相关配置信息,即默认数据库引擎和连接信息。
app/config/mail.php 为电子邮件发件引擎的配置文件,即 smtp 服务器,from:标头
app/config/session.php 控制laravel怎样管理用户sessions,即session driver, session lifetime。
app/config/view.php 模板系统的杂项配置。
app/controllers 包含用于提供基本的逻辑、 数据模型交互以及加载应用程序的视图文件的控制器类。
app/database/migrations/ 包含一些 php 类,允许 laravel更新当前数据库的架构并同时保持所有版本的数据库的同步。迁移文件是使用artisan工具生成的。
app/database/seeds/ 包含允许artisan工具用关系数据来填充数据库表的 php 文件。
app/lang/ php 文件,其中包含使应用程序易于本地化的字符串的数组。默认情况下目录包含英语语言的分页和表单验证的语言行。
app/models/ 模型是代表应用程序的信息(数据)和操作数据的规则的一些类。在大多数情况下,数据库中的每个表将对应应用中的一个模型。应用程序业务逻辑的大部分将集中在模型中。
app/start/ 包含与artisan工具以及全球和本地上下文相关的自定义设置。
app/storage/ 该目录存储laravel各种服务的临时文件,如session, cache, compiled view templates。这个目录在web服务器上必须是可以写入的。该目录由laravel维护,我们可以不关心。
app/tests/ 该文件夹给你提供了一个方便的位置,用来做单元测试。如果你使用phpunit,你可以使用artisan工具一次执行所有的测试。
app/views/ 该文件夹包含了控制器或者路由使用的html模版。请注意,这个文件夹下你只能放置模版文件。其他的静态资源文件如css, javascript和images文件应该放在/public文件夹下。
app/routes.php 这是您的应用程序的路由文件,其中包含路由规则,告诉 laravel 如何将传入的请求连接到路由处理的闭包函数、 控制器和操作。该文件还包含几个事件声明,包括错误页的,可以用于定义视图的composers。
app/filters.php 此文件包含各种应用程序和路由筛选方法,用来改变您的应用程序的结果。laravel 具有访问控制和 xss 保护的一些预定义筛选器。
4 hello, laravel!首先,我们来添加一些文字,在页面中显示。为了能访问网页,要启动程序服务器。
$ php artisan serve
上述命令会启动 php 内建的开发服务器,要查看程序,请打开一个浏览器窗口,访问 http://localhost:8000 。应该会看到默认的 laravel 信息页面:
要想停止服务器,请在命令行中按 ctrl+c 键。服务器成功停止后回重新看到命令行提示符。在大多数类 unix 系统中,包括 mac os x,命令行提示符是 $ 符号。
4.2 显示“hello, laravel!”要在 laravel 中显示“hello, laravel!”,需要新建一个控制器和视图。
控制器用来接受向程序发起的请求。路由决定哪个控制器会接受到这个请求。一般情况下,每个控制器都有多个路由,对应不同的动作。动作用来提供视图中需要的数据。
视图的作用是,以人类能看懂的格式显示数据。有一点要特别注意,数据是在控制器中获取的,而不是在视图中。视图只是把数据显示出来。默认情况下,视图使用 blade 编写,经由 laravel 解析后,再发送给用户。
控制器可用控制器生成器创建,你要告诉生成器,我想要个名为“welcome”的控制器,如下所示:
$ php artisan controller:make welcomecontroller --only=index
运行上述命令后,laravel 会生成 app/controllers/welcomecontroller.php 文件。生成文件后修改其中的 index 方法:
public function index() { return view::make('welcome.index'); }
**创建视图: **
在 app/views/ 目录新建文件夹 welcome 并创建文件 index.blade.php ;在 index.blade.php 文件中添加 hello, laravel! ;4.3 设置程序的首页我们已经创建了控制器和视图,现在要告诉 laravel 在哪个地址上显示“hello, laravel!”。这里,我们希望访问根地址 http://localhost:8000 时显示。但是现在显示的还是欢迎页面。
我们要告诉 laravel 真正的首页是什么。
在编辑器中打开 app/routes.php 文件。
'articles')) }}
这里,我们把 url 参数的值设为 articles 。对应的地址是 /articels,默认情况下,这个表单会向这个路由发起 post 请求。这个路由对应于 articlescontroller 控制器的 store 动作。
表单写好了,路由也定义了,现在可以填写表单,然后点击提交按钮新建文章了。
5.3 创建文章提交表单,会看到一个白屏。现在暂且不管这个错误。store 动作的作用是把新文章保存到数据库中。
提交表单后,其中的字段以参数的形式传递给 laravel。这些参数可以在控制器的动作中使用,完成指定的操作。要想查看这些参数的内容,可以把 store 动作改成:
public function store() { dd(input::all()); }
dd 函数为 laravel 内置的打印输出函数,input::all() 取得所有发出请求时传入的输入数据。
如果现在再次提交表单,不会再看到白屏错误,而是会看到类似下面的文字:
array (size=3) '_token' => string 'plx6trgrwfhakblkybuzkrth8r712ju4rwfipts7' (length=40) 'title' => string 'first article!' (length=14) 'text' => string 'this is my first article.' (length=25)
store 动作把表单提交的参数显示出来了。不过这么做没什么用,看到了参数又怎样,什么都没发生。
5.4 创建 article 模型在 laravel 中,模型的名字使用单数,对应的数据表名使用复数。
创建 app/models/article.php 并写入以下代码:
timestamps(); }); } /** * reverse the migrations. * * @return void */ public function down() { schema::drop('articles'); }}
修改其中的创建代码为:
schema::create('articles', function(blueprint $table) { $table->increments('id'); $table->string('title'); $table->text('text'); $table->timestamps(); });
在这个迁移中定义了一个名为 up 的方法,在运行迁移时执行。up 方法中定义的操作都是可以通过 down 方法实现可逆的,laravel 知道如何撤销这次迁移操作。运行迁移后,会创建 articles 表,以及一个字符串字段和文本字段。同时还会创建两个时间戳字段,用来跟踪记录的创建时间和更新时间。
然后,使用 artisan 命令运行迁移:
$ php artisan migrate
laravel 会执行迁移操作,告诉你创建了 articles 表。
migration table created successfully. migrated: 2014_09_03_084339_create_articles_table
5.6 在控制器中保存数据再回到 articlescontroller 控制器,我们要修改 store 动作,使用 article 模型把数据保存到数据库中。打开 app/controllers/articlescontroller.php 文件,把 store 动作修改成这样:
public function store() { $article = article::create(array('title'=>input::get('title'), 'text'=>input::get('text'))); return redirect::route('articles.show', array($article->id)); }
同时在 app/models/article.php 添加 :
protected $fillable = array('title', 'text');
fillable 属性允许在动作中调用模型的 create 方法使用 title 和 text 属性。
再次访问 http://localhost:8000/articles/create ,填写表单,还差一步就能创建文章了。
5.7 显示文章和前面一样,我们要在 app/controllers/articlescontroller.php 文件中更改 show 动作,以及相应的视图文件。
public function show($id) { $article = article::find($id); return view::make('articles.show', compact('article')); }
然后,新建 app/views/articles/show.blade.php 文件,写入下面的代码:
title: {{ $article->title }}
text: {{ $article->text }}
做了以上修改后,就能真正的新建文章了。访问 http://localhost:8000/articles/create ,自己试试。
5.8 列出所有文章我们还要列出所有文章,对应的路由是:
get|head articles | articles.index | articlescontroller@index
在 app/controllers/articlescontroller.php 文件中,修改 articlescontroller 控制器 index 动作:
public function index() { $articles = article::all(); return view::make('articles.index', compact('articles')); }
然后编写这个动作的视图,保存为 app/views/articles/index.blade.php:
listing articlestitle text
@foreach ($articles as $article) {{ $article->title }} {{ $article->text }}
@endforeach
现在访问 http://localhost:8000/articles ,会看到已经发布的文章列表。
5.9 添加链接至此,我们可以新建、显示、列出文章了。下面我们添加一些链接,指向这些页面。
打开 app/views/welcome/index.blade.php 文件,添加:
{{ link_to_route('articles.index', 'my blog') }}
link_to_route 是 laravel 内置的视图帮助方法之一,根据提供的文本和地址创建超链接。这上面这段代码中,地址是文章列表页面。
接下来添加到其他页面的链接。先在 app/views/articles/index.blade.php 中添加“new article”链接,放在
{{ link_to_route('articles.create', 'new article') }}
点击这个链接后,会转向新建文章的表单页面。
然后在 app/views/articles/create.blade.php 中添加一个链接,位于表单下面,返回到 index 动作:
{{ link_to_route('articles.index', 'back') }}
最后,在 app/views/articles/show.blade.php 模板中添加一个链接,返回 index 动作,这样用户查看某篇文章后就可以返回文章列表页面了:
{{ link_to_route('articles.index', 'back') }}
5.10 添加数据验证在 app/controllers/articlescontroller.php 文件中,修改 articlescontroller 控制器 store 动作:
public function store() { $rules = array('title' => 'required|min:5'); $validator = validator::make(input::all(), $rules); if ($validator->fails()) { return redirect::route('articles.create') ->witherrors($validator) ->withinput(); } $article = article::create(array('title'=>input::get('title'), 'text'=>input::get('text'))); return redirect::route('articles.show', array($article->id)); }
然后修改 app/views/articles/create.blade.php 添加 :
@if ($errors->any()) {{ count($errors->all()) }} prohibited this article from being saved: @foreach ($errors->all() as $message) {{ $message }} @endforeach
@endif
再次访问 http://localhost:8000/articles/create ,尝试发布一篇没有标题的文章,会看到一个很有用的错误提示。
5.11 更新文章我们已经说明了 crud 中的 cr 两种操作。下面进入 u 部分,更新文章。
首先,要在 articlescontroller 中更改 edit 动作:
public function edit($id) { $article = article::find($id); return view::make('articles.edit', compact('article')); }
视图中要添加一个类似新建文章的表单。新建 app/views/articles/edit.blade.php 文件,写入下面的代码:
editing article@if ($errors->any()) {{ count($errors->all()) }} prohibited this article from being saved: @foreach ($errors->all() as $message) {{ $message }} @endforeach
@endif{{ form::open(array('route' => array('articles.update', $article->id), 'method' => 'put')) }} {{ form::text('title', $article->title) }}
{{ form::text('text', $article->text) }}
{{ form::submit('submit') }}
{{ form::close() }}{{ link_to_route('articles.index', 'back') }}
这里的表单指向 update 动作
method: put ( patch ) 选项告诉 laravel,提交这个表单时使用 put 方法发送请求。根据 rest 架构,更新资源时要使用 http put 方法。
然后,要在 app/controllers/articlescontroller.php 中更新 update 动作:
public function update($id) { $rules = array('title' => 'required|min:5'); $validator = validator::make(input::all(), $rules); if ($validator->fails()) { return redirect::route('articles.create') ->witherrors($validator) ->withinput(); } $article = article::find($id); $article->title = input::get('title'); $article->text = input::get('text'); $article->save(); return redirect::route('articles.show', array($article->id)); }
最后,我们想在文章列表页面,在每篇文章后面都加上一个链接,指向 edit 动作。打开 app/views/articles/index.blade.php 文件,在“show”链接后面添加“edit”链接:
title text
@foreach ($articles as $article) {{ $article->title }} {{ $article->text }} {{ link_to_route('articles.show', 'show', $article->id) }} {{ link_to_route('articles.edit', 'edit', $article->id) }}
@endforeach
我们还要在 app/views/articles/show.blade.php 模板的底部加上“edit”链接:
{{ link_to_route('articles.index', 'back') }} |{{ link_to_route('articles.edit', 'edit', $article->id) }}
5.12 使用局部视图去掉视图中的重复代码编辑文章页面和新建文章页面很相似,显示错误提示的代码是相同的。下面使用局部视图去掉两个视图中的重复代码。
新建 app/views/notifications.blade.php 文件,写入以下代码:
@if ($errors->any()) {{ count($errors->all()) }} prohibited this article from being saved: @foreach ($errors->all() as $message) {{ $message }} @endforeach
@endif
下面来修改 app/views/articles/creat.blade.php 和 edit.blade.php 视图,使用新建的局部视图,把其中的上面代码全删掉,替换成:
@include('notifications')
5.13 删除文章现在介绍 crud 中的 d,从数据库中删除文章。按照 rest 架构的约定,删除文章的路由是:
delete articles/{articles} | articles.destroy | articlescontroller@destroy
删除资源时使用 delete 请求。如果还使用 get 请求,可以构建如下所示的恶意地址:
look at this cat!
删除资源使用 delete 方法,路由会把请求发往 app/controllers/articlescontroller.php 中的 destroy 动作。修改 destroy 动作:
public function destroy($id) { article::destroy($id); return redirect::route('articles.index'); }
想把记录从数据库删除,可以在模型对象上调用 destroy 方法。注意,我们无需为这个动作编写视图,因为它会转向 index 动作。
最后,在 index 动作的模板(app/views/articles/index.blade.php)中加上“destroy”链接:
title text
@foreach ($articles as $article) {{ $article->title }} {{ $article->text }} {{ link_to_route('articles.show', 'show', $article->id) }} {{ link_to_route('articles.edit', 'edit', $article->id) }} {{ form::open(array('method' => 'delete', 'route' => array('articles.destroy', $article->id))) }} {{ form::submit('delete') }} {{ form::close() }}
@endforeach
恭喜,现在你可以新建、显示、列出、更新、删除文章了。
接下来做什么至此,我们开发了第一个 laravel 程序,请尽情的修改、试验。在开发过程中难免会需要帮助,如果使用 laravel 时需要协助,可以使用这些资源:
http://laravel.com/http://golaravel.com/http://laravel-china.org/常见问题使用 laravel 时,最好使用 utf-8 编码存储所有外部数据。
如果编码出错,常见的征兆是浏览器中显示很多黑色方块和问号。还有一种常见的符号是“”,包含在“ü”中。
非 utf-8 编码的数据经常来源于:
你的文本编辑器:大多数文本编辑器(例如 textmate)默认使用 utf-8 编码保存文件。如果你的编辑器没使用 utf-8 编码,有可能是你在模板中输入了特殊字符(例如 é),在浏览器中显示为方块和问号。这种问题也会出现在国际化文件中。默认不使用 utf-8 保存文件的编辑器(例如 dreamweaver 的某些版本)都会提供一种方法,把默认编码设为 utf-8。记得要修改。你的数据库:默认情况下,laravel 会把从数据库中取出的数据转换成 utf-8 格式。如果数据库内部不使用 utf-8 编码,就无法保存用户输入的所有字符。例如,数据库内部使用 latin-1 编码,用户输入俄语、希伯来语或日语字符时,存进数据库时就会永远丢失。如果可能,在数据库中尽量使用 utf-8 编码。特别感谢原作者: http://www.lapland.name/(拉普兰德)