laravel5.5之请求

laravel5.5之请求

获取请求
use Illuminate\Http\Request;

使用依赖注入的方式
class UserController extends Controller
{
    public function update(Request $request, $id)
    {
        //
    }
}

Request对象几个常用的方法

path()
	path 方法返回请求的路径信息。也就是说，如果传入的请求的目标地址是 http://domain.com/foo/bar，那么 path 将会返回 foo/bar：
	$uri = $request->path();

is()
	is 方法可以验证传入的请求路径和指定规则是否匹配。使用这个方法的时，你也可以传递一个 * 字符作为通配符：
	if ($request->is('admin/*')) {
	    //
	}

url()和fullUrl()
	获取请求的 URL
	你可以使用 url 或 fullUrl 方法去获取传入请求的完整 URL。url 方法返回不带有查询字符串的 URL，而 fullUrl 方法的返回值包含查询字符串：

	// Without Query String...
	$url = $request->url();

	// With Query String...
	$url = $request->fullUrl();

method()和isMethod()
	对于传入的请求 method 方法将返回 HTTP 的请求方式。你也可以使用 isMethod 方法去验证 HTTP 的请求方式与指定规则是否相配：

	$method = $request->method();

	if ($request->isMethod('post')) {
	    //
	}

获取输入
	获取所有输入数据 all()
	$input = $request->all();// 以数组形式获取到所有输入数据:

	获取指定输入值 input()
	使用几种简单的方法（不需要特别指定哪个 HTTP 动作），就可以访问 Illuminate\Http\Request 实例中所有的用户输入。也就是说无论是什么样的 HTTP 动作，input 方法都可以被用来获取用户输入数据：
	$name = $request->input('name');
	$name = $request->input('name', 'Sally');// 默认值
	如果传输表单数据中包含「数组」形式的数据，那么可以使用「点」语法来获取数组：
	$name = $request->input('products.0.name');
	$names = $request->input('products.*.name');

	只从查询字符串获取输入 
	$name = $request->query('name');
	$name = $request->query('name', 'Helen');
	$query = $request->query();// 以关联数组的形式检索所有查询字符串值

	获取 JSON 输入信息
	如果发送到应用程序的请求数据是 JSON，只要请求的 Content-Type 标头正确设置为 application/json，就可以通过 Input 方法访问 JSON 数据。你甚至可以使用 「点」语法来读取 JSON 数组：
	$name = $request->input('user.name');

	获取部分输入数据
	如果你需要获取输入数据的子集，则可以用 only 和 except 方法。这两个方法都接收 数组 或动态列表作为参数：
	$input = $request->only(['username', 'password']);
	$input = $request->only('username', 'password');
	$input = $request->except(['credit_card']);
	$input = $request->except('credit_card');
	{tip} only 方法会返回所有你指定的键值对，但不会返回请求中不存在的键值对。

确定是否存在输入值
	if ($request->has('name')) {
	    //
	}
	当提供一个数组作为参数时，has 方法将确定是否存在数组中所有给定的值：
	if ($request->has(['name', 'email'])) {
	    //
	}
	如果你想确定请求中是否存在值并且不为空，可以使用 filled 方法：
	if ($request->filled('name')) {
	    //
	}

将输入闪存至 Session
	将当前输入的数据存进 session 中
	$request->flash();
	$request->flashOnly(['username', 'email']);
	$request->flashExcept('password');

	闪存输入后重定向
	你可能需要把输入闪存到 session 然后重定向到上一页，这时只需要在重定向方法后加上 withInput 即可：
	return redirect('form')->withInput();

	return redirect('form')->withInput(
	    $request->except('password')
	);

获取闪存
	$username = $request->old('username');
	Laravel 也提供了全局辅助函数 old。如果你要在 Blade 模板 中显示旧的输入，使用 old 会更加方便。如果给定字段没有旧的输入，则返回 null：
	<input type="text" name="username" value="{{ old('username') }}">

Cookies
	从请求中获取 Cookie
	Laravel 框架创建的每个 cookie 都会被加密并使用验证码进行签名，这意味着如果客户端更改了它们，便视为无效。
	$value = $request->cookie('name');

	将 Cookies 附加到响应
	传递 Cookie 名称、值、以及有效期（分钟）
	Illuminate\Http\Response
	return response('Hello World')->cookie(
	    'name', 'value', $minutes
	);

	return response('Hello World')->cookie(
	    'name', 'value', $minutes, $path, $domain, $secure, $httpOnly
	);

	生成 Cookie 实例
	如果你想要在一段时间以后生成一个可以给定 Symfony\Component\HttpFoundation\Cookie 的响应实例，你可以使用全局辅助函数 cookie。除非此 cookie 被附加到响应实例，否则不会发送回客户端：

	$cookie = cookie('name', 'value', $minutes);

	return response('Hello World')->cookie($cookie);

文件
	获取上传文件
	你可以使用 file 方法或使用动态属性从 Illuminate\Http\Request 实例中访问上传的文件。该 file 方法返回一个 Illuminate\Http\UploadedFile 类的实例，该类继承了PHP 的 SplFileInfo 类的同时也提供了各种与文件交互的方法：
	$file = $request->file('photo');
	// or
	$file = $request->photo;

	你可以使用 hasFile 方法确认请求中是否存在文件：

	if ($request->hasFile('photo')) {
	    //
	}

	验证成功上传
	除了检查上传的文件是否存在外，你也可以通过 isValid 方法验证上传的文件是否有效：

	if ($request->file('photo')->isValid()) {
	    //
	}

	文件路径 & 扩展名
	UploadedFile 类还包含访问文件的完整路径及其扩展名方法。extension 方法会根据文件内容判断文件的扩展名。该扩展名可能会和客户端提供的扩展名不同：

	$path = $request->photo->path();

	$extension = $request->photo->extension();

	存储上传文件
	要存储上传的文件，先配置好 文件系统。你可以使用 UploadedFile 的 store 方法把上传文件移动到磁盘或云存储
	store 方法接受相对于文件系统配置的存储文件根目录的路径。这个路径不能包含文件名，因为系统会自动生成唯一的 ID 作为文件名。

	store 方法还接受可选的第二个参数，用于存储文件的磁盘名称。这个方法会返回相对于磁盘根目录的文件路径：

	$path = $request->photo->store('images');

	$path = $request->photo->store('images', 's3');
	如果你不想自动生成文件名，那么可以使用 storeAs 方法，它接受路径、文件名和磁盘名作为其参数：

	$path = $request->photo->storeAs('images', 'filename.jpg');

	$path = $request->photo->storeAs('images', 'filename.jpg', 's3');