Translate controller.md (v5.5) #362

Nationalcat · 2017-10-31T17:18:32Z

Translate `controller.md` (v5.5)

已同步原始文件最近的更新

neighborhood999

再麻煩檢查一下程式碼註解部分有沒有缺漏翻譯的，謝謝！

neighborhood999 · 2017-11-13T02:18:58Z

controllers.md

+    - [部分資源路由](#restful-partial-resource-routes)
+    - [為資源路由命名](#restful-naming-resource-routes)
+    - [為資源路由命名的參數](#restful-naming-resource-route-parameters)
+    - [在地化資源的 URI](#restful-localizing-resource-uris)


「本地化」感覺比較好一些

neighborhood999 · 2017-11-13T02:25:13Z

controllers.md


-Below is an example of a basic controller class. Note that the controller extends the base controller class included with Laravel. The base class provides a few convenience methods such as the `middleware` method, which may be used to attach middleware to controller actions:
+這是一個基礎控制器類別的範例。所有 Laravel 控制器都應繼承基礎控制器類別，它包含在 Laravel 的預設安裝中：


以下是一個基礎控制器類別的範例。注意 Laravel 控制器都應繼承基礎控制器類別。基礎類別提供了一些方便的方法，像是 middleware 方法，可以把中介層附加到控制器的行為：

neighborhood999 · 2017-11-13T02:37:31Z

controllers.md


    Route::get('user/{id}', 'UserController@show');

-Now, when a request matches the specified route URI, the `show` method on the `UserController` class will be executed. Of course, the route parameters will also be passed to the method.
+現在，當請求和此特定的路由 URI 相匹配時，`UserController` 類別的 `showProfile` 方法就會被執行。當然，路由的參數也會被傳遞至該方法。


現在，當一個請求匹配指定的路由 URI 時，在 UserController 類別的 show 方法將會被執行。當然，路由參數也可以被傳送到方法。

neighborhood999 · 2017-11-13T02:41:28Z

controllers.md


-> {tip} Controllers are not **required** to extend a base class. However, you will not have access to convenience features such as the `middleware`, `validate`, and `dispatch` methods.
+> {tip} 控制器不**需要**再繼承基礎類別。然而，你將無法存取一些方便的功能，比如 `middleware`、`validate` 和 `dispatch` 這些方法。


控制器不需要強制去繼承基礎類別。然而，你將無法存取一些方便的功能，像是 middleware、validate 和 dispatch 這些方法。

neighborhood999 · 2017-11-13T02:48:15Z

controllers.md


-It is very important to note that we did not need to specify the full controller namespace when defining the controller route. Since the `RouteServiceProvider` loads your route files within a route group that contains the namespace, we only specified the portion of the class name that comes after the `App\Http\Controllers` portion of the namespace.
+有一點非常重要，那就是我們在定義控制器路由時，不需要指定完整的控制器命名空間。因為 `RouteServiceProvider` 已經把命名空間寫入路由群組中，並且會載到你的路由檔案，我們只需要指定 `App\Http\Controllers` 命名空間之後的類別名稱部分。


有一點非常重要，當我們在定義控制器路由時，我們不需要指定完整的控制器命名空間。由於 RouteServiceProvider 載入你的路由檔案內的路由群組包含了命名空間，我們只需要指定命名空間 App\Http\Controllers 部分之後的類別名稱部分。

neighborhood999 · 2017-11-14T01:34:25Z

controllers.md


    /user/{admin_user}

 <a name="restful-localizing-resource-uris"></a>
-### Localizing Resource URIs
+### 在地化資源的 URI


neighborhood999 · 2017-11-14T01:38:15Z

controllers.md


-By default, `Route::resource` will create the route parameters for your resource routes based on the "singularized" version of the resource name. You can easily override this on a per resource basis by passing `parameters` in the options array. The `parameters` array should be an associative array of resource names and parameter names:
+預設的 `Route::resource` 會根據「奇數」版本的資源名稱建立資源路由的路由參數。你能透過在選項陣列中傳遞 `parameters` 來輕鬆的覆蓋每個資源。`parameters` 陣列應該是與資源名稱或參數名稱有關的陣列：


預設上，Route::resource 會根據「單一化」版本的資源名稱建立資源路由的路由參數。你能透過在選項陣列中傳遞 parameters 來輕鬆的覆蓋每個資源。parameters 陣列應該是與資源名稱或參數名稱有關的陣列：

neighborhood999 · 2017-11-14T01:38:35Z

controllers.md


-By default, `Route::resource` will create resource URIs using English verbs. If you need to localize the `create` and `edit` action verbs, you may use the `Route::resourceVerbs` method. This may be done in the `boot` method of your `AppServiceProvider`:
+預設 `Route::resource` 會使用英文動詞來建立資源的 URI。如果你需要將 `create` 和 `edit` 行為動詞給在地化翻譯，你可以使用 `Route::resourceVerbs` 方法。這可以在你的 `AppServiceProvider` 的 `boot` 方法中完成這件事：


本地化翻譯

neighborhood999 · 2017-11-14T01:41:41Z

controllers.md


    Route::get('photos/popular', 'PhotoController@method');

    Route::resource('photos', 'PhotoController');

-> {tip} Remember to keep your controllers focused. If you find yourself routinely needing methods outside of the typical set of resource actions, consider splitting your controller into two, smaller controllers.
+> {tip} 請記得維持控制器的重點。如果你發現自己經常需要用到典型資源以外的方法，建議將控制器拆分為兩個較小的控制器。


記住要保持你的控制器的重點。

neighborhood999 · 2017-11-14T01:45:38Z

controllers.md


-In addition to constructor injection, you may also type-hint dependencies on your controller's methods. A common use-case for method injection is injecting the `Illuminate\Http\Request` instance into your controller methods:
+除了建構子注入外，你也可以在你的控制器方法上注入依賴。方法注入的常用案例是注入 `Illuminate\Http\Request` 實例到你的控制器方法：


除了建構子注入外，你也可以在你的控制器的方法上類型提示依賴。

Nationalcat mentioned this pull request Oct 31, 2017

Laravel 5.5 文件翻譯 #340

Open

73 tasks

neighborhood999 reviewed Nov 14, 2017

View reviewed changes

Nationalcat added 2 commits November 14, 2017 11:56

translate controller.md (v5.5)

d3a4fad

11/14 修正翻譯問題、補充註解翻譯以及同步翻譯原始文件最新內容

624a4f6

Nationalcat force-pushed the 5.5-controller branch from a930763 to 624a4f6 Compare November 14, 2017 03:58

neighborhood999 merged commit 9a673c1 into laravel-taiwan:5.5 Nov 14, 2017

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Translate controller.md (v5.5) #362

Translate controller.md (v5.5) #362

Nationalcat commented Oct 31, 2017

neighborhood999 left a comment

neighborhood999 Nov 13, 2017

neighborhood999 Nov 13, 2017

neighborhood999 Nov 13, 2017

neighborhood999 Nov 13, 2017

neighborhood999 Nov 13, 2017

neighborhood999 Nov 14, 2017

neighborhood999 Nov 14, 2017

neighborhood999 Nov 14, 2017

neighborhood999 Nov 14, 2017

neighborhood999 Nov 14, 2017


		Below is an example of a basic controller class. Note that the controller extends the base controller class included with Laravel. The base class provides a few convenience methods such as the `middleware` method, which may be used to attach middleware to controller actions:
		這是一個基礎控制器類別的範例。所有 Laravel 控制器都應繼承基礎控制器類別，它包含在 Laravel 的預設安裝中：


		> {tip} Controllers are not required to extend a base class. However, you will not have access to convenience features such as the `middleware`, `validate`, and `dispatch` methods.
		> {tip} 控制器不需要再繼承基礎類別。然而，你將無法存取一些方便的功能，比如 `middleware`、`validate` 和 `dispatch` 這些方法。


		It is very important to note that we did not need to specify the full controller namespace when defining the controller route. Since the `RouteServiceProvider` loads your route files within a route group that contains the namespace, we only specified the portion of the class name that comes after the `App\Http\Controllers` portion of the namespace.
		有一點非常重要，那就是我們在定義控制器路由時，不需要指定完整的控制器命名空間。因為 `RouteServiceProvider` 已經把命名空間寫入路由群組中，並且會載到你的路由檔案，我們只需要指定 `App\Http\Controllers` 命名空間之後的類別名稱部分。


		By default, `Route::resource` will create the route parameters for your resource routes based on the "singularized" version of the resource name. You can easily override this on a per resource basis by passing `parameters` in the options array. The `parameters` array should be an associative array of resource names and parameter names:
		預設的 `Route::resource` 會根據「奇數」版本的資源名稱建立資源路由的路由參數。你能透過在選項陣列中傳遞 `parameters` 來輕鬆的覆蓋每個資源。`parameters` 陣列應該是與資源名稱或參數名稱有關的陣列：


		By default, `Route::resource` will create resource URIs using English verbs. If you need to localize the `create` and `edit` action verbs, you may use the `Route::resourceVerbs` method. This may be done in the `boot` method of your `AppServiceProvider`:
		預設 `Route::resource` 會使用英文動詞來建立資源的 URI。如果你需要將 `create` 和 `edit` 行為動詞給在地化翻譯，你可以使用 `Route::resourceVerbs` 方法。這可以在你的 `AppServiceProvider` 的 `boot` 方法中完成這件事：


		In addition to constructor injection, you may also type-hint dependencies on your controller's methods. A common use-case for method injection is injecting the `Illuminate\Http\Request` instance into your controller methods:
		除了建構子注入外，你也可以在你的控制器方法上注入依賴。方法注入的常用案例是注入 `Illuminate\Http\Request` 實例到你的控制器方法：

Translate controller.md (v5.5) #362

Translate controller.md (v5.5) #362

Conversation

Nationalcat commented Oct 31, 2017

Translate controller.md (v5.5)

neighborhood999 left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Translate `controller.md` (v5.5)