当前位置: 首页 > 工具软件 > Laravel > 使用案例 >

laravel入门教程(一)

慕烨烁
2023-12-01

laravel入门教程(一)

本教程是针对 laravel 5 来讲解的
####0.1、一个简单的示例

//文件:routes/web.php
<?php
Route::get('/','WelcomeController@index');

//文件:app/Http/Controllers/WelcomeController.php
<?php
namescpace app\Http\Controllers;

class WelcomeController{
	public function index(){
		return 'Hello, World!';
	}
}

访问http://xxxxxxxxx.xxx/ 就可以看见“Hello,World!”。
实际上,这种写法等价于另一种更为简便的写法

//文件:routes/web.php
<?php
Route::get('/',function(){
	return 'Hello, World!';
});

但是,为了保持与后面讲解内容的一致性和代码编写的一致性,最好使用第一种方法。第一种方法的第一个文件中定义了路由,当访问‘/’的路由的时候,就去找WelcomeController里面的index方法。第二个文件定义的就是WelcomeController控制器以及它的index方法。

####0.2、一个访问数据库数据的demo

//文件:routes/web.php
<?php
Route::get('/',function{
	return Greeting::first()->body;
});
//文件:app/Greeting.php
//这个是模型文件
<?php
use Illuminate\Database\Eloquent\Model;

class Greeting extends Model{}

//文件:database/migrations/2018_06_03_123123_create_greetings_table.php
//这个是数据库迁移文件,后面会详细讲解
<?php
 use Illuminate\Database\Migrations\Migration;
 use Illuminate\Database\Schema\Blueprint;
 class CreateGreetingsTable extends Migration{
	 public function up(){
		 Schema::create('greetings',function(Blueprint $table){
			$table->increments('id');
			$table->string('body');
			$table->timestamps();
		 });
	 }//创建数据库的文件,这些文件都可以使用artisan命令自动生成,内容自己填充
	
	 public function down(){
		 Schema::drop('greetings');
	 }//销毁数据库时的操作
 }
 

如果在greetings数据库里面存入一条数据:“Hello, World!”。就可以在首页看到了。

下面开始正式学习laravel
####1、创建一个新的laravel项目
1.1、使用Laravel安装工具来安装Laravel
(1)、开发全局安装Composer
(2)、运行

composer global require “laravel/installer=~1.1”

安装laravel安装工具。启动一个全向的Laravel项目:

laravel new projectName

此命令会在当前目录下创建一个新的名为 projectName 的子目录,并在其中安装 一个全新的Laravel项目

1.2、使用Composer的create-project 来安装Laravel
(1)、输入以下命令:

composer create-project laravel/laravel projectName --prefer-dist

此命令会在当前目录下创建一个新的名为 projectName 的子目录,并在其中安装 一个全新的Laravel项目

1.3、创建好Laravel项目之后,生成的项目结构大致如下(因为版本不一样,可能稍有区别)

新安装的 Laravel 应用包含许多文件夹:
app目录包含了应用的核心代码;
bootstrap目录包含了少许文件用于框架的启动和自动载入配置,还有一个cache文件夹用于包含框架生成的启动文件以提高性能;

config目录包含了应用所有的配置文件;

database目录包含了数据迁移及填充文件,如果你喜欢的话还可以将其作为 SQLite 数据库存放目录;

public目录包含了前端控制器和资源文件(图片、JavaScript、CSS等);

resources目录包含了视图文件及原生资源文件(LESS、SASS、CoffeeScript),以及本地化文件;

storage目录包含了编译过的Blade模板、基于文件的session、文件缓存,以及其它由框架生成的文件,该文件夹被细分为成app、framework和logs子目录,app目录用于存放应用要使用的文件,framework目录用于存放框架生成的文件和缓存,最后,logs目录包含应用的日志文件;

tests目录包含自动化测试,其中已经提供了一个开箱即用的PHPUnit示例;

vendor目录包含Composer依赖;

App目录

应用的核心代码位于app目录下,默认情况下,该目录位于命名空间 App 下, 并且被 Composer 通过 PSR-4自动载入标准 自动加载。你可以通过Artisan命令app:name来修改该命名空间。

app目录下包含多个子目录,如Console、Http、Providers等。Console和Http目录提供了进入应用核心的API,HTTP协议和CLI是和应用进行交互的两种机制,但实际上并不包含应用逻辑。换句话说,它们只是两个向应用发布命令的方式。Console目录包含了所有的Artisan命令,Http目录包含了控制器、中间件和请求等。

Jobs目录是放置队列任务的地方,应用中的任务可以被队列化,也可以在当前请求生命周期内同步执行。

Events目录是放置事件类的地方,事件可以用于通知应用其它部分给定的动作已经发生,并提供灵活的解耦的处理。

Listeners目录包含事件的处理器类,处理器接收一个事件并提供对该事件发生后的响应逻辑,比如,UserRegistered事件可以被SendWelcomeEmail监听器处理。

Exceptions目录包含应用的异常处理器,同时还是处理应用抛出的任何异常的好地方。

注意:app目录中的很多类都可以通过Artisan命令生成,要查看所有有效的命令,可以在终端中运行php artisan list make命令。

####2、配置
内容包括数据库连接,队列以及邮件设置都放置在config文件夹中。这里的每一个文件都将返回一个数组,数组中的每个值都可以通过一个配置键进行访问,该配置键有文件名和后续的键组成,以点好(.)进行分隔。所以,可以在config/services.php中创建如下所示的信息。

// config/services.php
return [
	'sparkpost' => [
		'secret' => 'aaaaaa'
	]
];

现在可以使用

config('services.sparkpost.secret)

访问配置好的变量了。

每个环境中的任何配置变量都应该放在.env文件中(而不是提交给源代码控制)。如果希望在每个环境使用不同的Bugsnag API密钥,可以将配置信息从.env中提取出来,如下所示:

//config/services.php
return [
	'bugsnag' => [
		'api_key' => env('BUGSNAG_API_KEY')
	]
];

.env()这个函数可以从.env文件中提取出该键名所对应的值。现在可以将该键名对应的信息添加到.env(当前环境的设置)和.env.example(适用于所有环境的模板)文件中。

BUGSNAG_API_KEY = oinfp9813410942

####3、路由和控制器
在学习web框架时,定义好应用程序的路由是第一个也是最重要的一个环节。没有路由,就无法与终端用户进行交互。

在一个laravel应用程序中,一般是在routes/web.php中定义路由。如果是api的路由,则在api.php中定义路由。示例0.1就是一个路由定义的例子。

在详细介绍路由之前,先介绍几个概念:

闭包:闭包是php版本的匿名函数。闭包是一个函数,可以将它作为一个对象传递,并赋值给一个变量,将其作为参数传递给其他的函数和方法,甚至进行序列化。
中间件:laravel的请求和响应的过程包含很多封装起来的内容,包括所谓的中间件。仅仅定义路由闭包以及控制器方法,还不足以将输出发送给浏览器,所以这里采用返回内容的方式,这样返回的内筒可以继续在response stack以及中间件中运行(即继续在程序中处理该返回的内容),运行完成后再返回给浏览器共终端用户查看。

demo3.1

//简单的网站

Route::get('/',function(){
	return view('welcome');
});

Route::get('about',function(){
	return view('about');
});

Route::get('products',function(){
	return view('products');
});
Route::get('services',function(){
	return view('services');
});

上面的代码等价于

$router->get('/',function(){
	return view('welcome');
});

$router->get('about',function(){
	return view('about');
});

$router->get('products',function(){
	return view('products');
});
$router->get('services',function(){
	return view('services');
});

常用的HTTP方法有:GET/POST/PUT/DELETE/PATCH
进行替换就可以了。例如:

Route::get('/',function(){
	return '123';
});

Route::post('/',function(){
	return '456';
});

Route::put('/',function(){});
Route::delete('/',function(){});
Route::any('/',function(){});
Route::match(['get','post'],'/',function(){});

另一种方法是将控制器名称和方法作为字符串传递给闭包

Route::get('/','WelcomeController@index');

路由参数:如果定义的路由具有参数(可变的额URL地址段),那么可以在路由中定义它们,并将它们传递给闭包。

//路由参数示例
Route::get('users/{id}/friends',function(){
	//
});

一般只有get方法这样写参数。
在录用参数({id})中使用相同的名称,以及将对应的名字添加到路由定义的方法参数中(function{$sid)是十分常见的。除非使用路由/模型绑定,否则定义的路由参数与哪个方法参数相匹配仅由它们的顺序(从左到右)决定,如以下代码所示。

Route::get('users'/{userId}/comments/{commentId}',function(
	$thisIsActuallyTheRouteId,
	$thisisReallyTheCommentId
	){
	//
});

也就是说,可以让它们使用不同的名称,也可以使用相同的名称。这里建议使它们的名称保持一致,以免未来开发人员在使用的时候可能因为不一致的命名而出现问题。
还可以用过在参数名称后添加一个问号(?)来实现路由参数的选择。

//可选路由参数
Route::get('users/{id?}',function($id = 'fallbackId'){
	//
});

在这种情况下,应该为相应的路由变量设置好默认值。并且可以使用正则表达式来定义一个路由,这个时候,只有该参数满足特定的模式时才会匹配

//通过正则表达式来定义路由
Route::get(;users/{id}',function($id){
	//
})->where('id','[0-9]+');

Route::get('users/{username}',function($username){
	//
})->where('username','[A-Za-z]+');

Route::get('posts/{id}/{slug}',function($id,$slug){
	//
})->where(['id'] => '[0-9]+',]slug' => '[A-Za-z]+');

路由名称
url()助手函数:写相对路径,可以自动补全站点全称

//在routes/web.php中定义具有名称的路由
Route::get('members/{id}','MembersController@show')->name('members.show');

//使用route()助手在视图中链接路由
<a href="<php echo route('members.show',['id' = 4]); ?>">

路由组
允许多个路由组合在一起,并且可以将任何共享的配置应用于整个组,从而避免配置信息的重复。

//定义一个路由组
Route::group([],function(){
	Route::get('hello',function(){
		return 'Hello';
	});
	Route::get('world',function(){
		return ' World!';
	});
});

传入的空数组允许传递各种配置信息,这些配置将对组内的所有路由都生效。

中间件
路由组最常见的功能就是将中间件应用于一组路由中,但是在其他方面,路由组也常常被应用在权限控制方面。

//将一组路由限制为只允许登录用户访问
Route::group(['middleware' => 'auth'],function(){
	Route::get('aaa',function(){
		return view('aaaa');
	});
	Route::get('bbb',function(){
			return view('bbbb');
	});
});

此时中间件auth对aaa和bbb这两者都会生效。在此示例中,表示用户必须登录后才能查看控制中心(aaa)或账户页面(bbb)。

中间件在控制器中的应用:
通常,在控制器中使用中间件比在路由中使用中间件更为清晰和直接。可以在控制器中调用middleware()方法来使用中间件。参数代表中间件的名称,可以使用modifier方法(only()和except())来确定将由哪些方式接收中间件

class DashboardController extends Controller{
	public function __construct(){
		$this->middleware('auth');
		$this->middleware('admin-auth')->only('admin');
		$this->middleware('team-member')->except('admin');
	}
}

路径前缀

//为一组路由设置路径前缀
Route::group(['prefix' => 'api'],function(){
	Route::get('/',function(){
		//设置path /api
	});

	Route::get('users',function(){
		//设置path /api/users
	});
});

子域名路由
子域名路由的作用域是子域名,而不是路由前缀

//子域名路由
Route::group(['domain' => 'api.myapp.com'],function(){
	Route::get('/',function(){
		//
	});
});

//参数化的子域名路由
Route::group(['domain'=> '{acount}.myapp.com'],function(){
	Route::get('/',function($acount){
		//
	});
	Route::get('users/{id}',function($acount,$id){
		//
	});
});
 类似资料: