Translate container.md (v5.5) #357

Nationalcat · 2017-10-23T14:27:30Z

Translate `container.md` (v5.5)

翻譯原始文件新增的內容（ v5.3->v5.5 ）
大量引用v5.3翻譯，不過有修正一些翻譯來增加可讀性
type-hint 在本文件中一直被當動詞使用，可是如果把型別提示當成動名詞使用，可讀性會很低。
目前稍微用注入來取代

neighborhood999

Review 有任何問題都可以討論

neighborhood999 · 2017-11-08T08:15:51Z

container.md

-    - [The Make Method](#the-make-method)
-    - [Automatic Injection](#automatic-injection)
- [Container Events](#container-events)
+# 服務容器（ Container ）


不需要 Container & 大括號

neighborhood999 · 2017-11-08T08:18:55Z

container.md


-The Laravel service container is a powerful tool for managing class dependencies and performing dependency injection. Dependency injection is a fancy phrase that essentially means this: class dependencies are "injected" into the class via the constructor or, in some cases, "setter" methods.
+Laravel 服務容器（Container）是管理類別依賴與執行依賴注入的強大工具。依賴注入是個花俏的名詞，實際上是指：類別的依賴透過建構子「注入」，或在某些情況下透過「setter」方法注入。


不需要 Container & 大括號

neighborhood999 · 2017-11-08T08:25:59Z

container.md

@@ -61,65 +61,65 @@ Let's look at a simple example:
        }
    }

-In this example, the `UserController` needs to retrieve users from a data source. So, we will **inject** a service that is able to retrieve users. In this context, our `UserRepository` most likely uses [Eloquent](/docs/{{version}}/eloquent) to retrieve user information from the database. However, since the repository is injected, we are able to easily swap it out with another implementation. We are also able to easily "mock", or create a dummy implementation of the `UserRepository` when testing our application.
+在這例子中，`UserController` 需要從資料來源中取得使用者，所以我們將要**注入** `UserRepository` 該服務來取得使用者。在這種情況下，`UserRepository` 像是使用 [Eloquent](/docs/{{version}}/eloquent) 取得在資料庫中有關使用者的資訊。由於儲存庫是被注入的，因此我們才能輕易地切換其他的實作。當我們在做測試的時候，一樣也能輕易地「模擬（mock）」，或建立假的 `UserRepository` 實作來測試我們的程式。


在這個範例中，UserController 需要從資料來源中取得使用者。所以我們將注入一個服務讓我們能取得使用者。在這個情境下，我們的 UserRepository 像是使用 Eloquent 一樣，從資料庫取得使用者資訊。然而，由於 Repository 是被注入的，我們可以更容易的抽換成其他的實作。我們可以很容易的「mock」，或是建立一個假的 UserRepository 實作來測試我們的應用程式。

這裡保留 Repository & Mock 這兩詞。

neighborhood999 · 2017-11-08T08:30:54Z

container.md


-A deep understanding of the Laravel service container is essential to building a powerful, large application, as well as for contributing to the Laravel core itself.
+深入地理解 Laravel 服務容器，對於構建功能強大的大型 Laravel 應用程式而言至關重要。甚至是貢獻 Laravel 核心的程式碼也是不可或缺的。


深入了解 Laravel 的服務容器對於建立一個強大、大型的應用程式以及為 Laravel 核心程式碼本身做出貢獻是必要的。

neighborhood999 · 2017-11-08T08:33:21Z

container.md


-Almost all of your service container bindings will be registered within [service providers](/docs/{{version}}/providers), so most of these examples will demonstrate using the container in that context.
+幾乎所有的服務容器綁定都會在[服務提供者](/docs/{{version}}/providers)中註冊，所以下方所有的例子將示範在該情境中使用容器。


幾乎所有的服務容器綁定都會在服務提供者中被註冊，所以下方所有的範例將示範在該情境中使用容器。

neighborhood999 · 2017-11-08T09:03:27Z

container.md


    $api = resolve('HelpSpot\API');

-If some of your class' dependencies are not resolvable via the container, you may inject them by passing them as an associative array into the `makeWith` method:
+如果你有一些類別的依賴不能透過容器來解析，你可以將它們弄成一組關聯陣列傳到 `makeWith` 方法來注入：


如果你有一些類別的依賴不能透過容器來解析，你可以將它們組成為關聯陣列傳入到 makeWith 方法來注入：

neighborhood999 · 2017-11-08T09:11:59Z

container.md


-For example, you may type-hint a repository defined by your application in a controller's constructor. The repository will automatically be resolved and injected into the class:
+舉個例子，你可以在控制器的建構子中對應用程式中定義的儲存庫進行型別提示。儲存庫會自動被解析及注入至類別中：


例如，你可以透過你應用程式控制器的建構子型別提示一個被定義的 Repository。Repository 將自動地被解析並注入到類別中：

neighborhood999 · 2017-11-08T09:13:30Z

container.md


-The service container fires an event each time it resolves an object. You may listen to this event using the `resolving` method:
+每當服務容器解析一個物件時就會觸發事件。你可以使用 `resolving` 方法監聽這個事件：

    $this->app->resolving(function ($object, $app) {
        // Called when container resolves object of any type...


當容器解析任何的類型物件時被呼叫

neighborhood999 · 2017-11-08T09:13:52Z

container.md

@@ -251,12 +251,12 @@ The service container fires an event each time it resolves an object. You may li
        // Called when container resolves objects of type "HelpSpot\API"...


當容器解析「HelpSpot\API」的類型物件時被呼叫

neighborhood999 · 2017-11-08T09:15:16Z

container.md

@@ -251,12 +251,12 @@ The service container fires an event each time it resolves an object. You may li
        // Called when container resolves objects of type "HelpSpot\API"...
    });

-As you can see, the object being resolved will be passed to the callback, allowing you to set any additional properties on the object before it is given to its consumer.
+如你所見，被解析的物件會被傳遞至回呼函式中，從而允許你在傳遞給消費者之前，設置任何額外的屬性至物件。


如你所見，被解析的物件會被傳遞至回呼函式中，在它被提供給它的消費者之前，允許你在物件上設定任何額外的屬性。

neighborhood999 · 2017-11-09T06:40:55Z

文件內部分的程式碼區塊的註解再麻煩翻譯一下，謝謝！

Nationalcat · 2017-11-09T10:41:14Z

已補從註解翻譯了，麻煩再檢查一下，感恩

neighborhood999 · 2017-11-09T13:30:29Z

container.md

@@ -48,7 +48,7 @@ Let's look at a simple example:
        }

        /**
-         * Show the profile for the given user.
+         * 顯示給定使用者個資。


顯示個人資料給特定使用者。

Nationalcat force-pushed the 5.5-container branch from 0c853ca to 500c59e Compare October 23, 2017 14:32

Nationalcat mentioned this pull request Oct 23, 2017

Laravel 5.5 文件翻譯 #340

Open

73 tasks

neighborhood999 reviewed Nov 8, 2017

View reviewed changes

Nationalcat added 2 commits November 8, 2017 18:38

translate container.md (v5.5)

c06a88d

11/8 修正翻譯問題

a4f2dda

Nationalcat force-pushed the 5.5-container branch from 500c59e to a4f2dda Compare November 8, 2017 14:44

11/9 補充程式碼註解翻譯

405d277

neighborhood999 reviewed Nov 9, 2017

View reviewed changes

11/9 修正註解翻譯問題

73fbe11

neighborhood999 merged commit 49aa1b5 into laravel-taiwan:5.5 Nov 9, 2017

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Translate container.md (v5.5) #357

Translate container.md (v5.5) #357

Nationalcat commented Oct 23, 2017

neighborhood999 left a comment

neighborhood999 Nov 8, 2017

neighborhood999 Nov 8, 2017

neighborhood999 Nov 8, 2017

neighborhood999 Nov 8, 2017

neighborhood999 Nov 8, 2017

neighborhood999 Nov 8, 2017

neighborhood999 Nov 8, 2017

neighborhood999 Nov 8, 2017

neighborhood999 Nov 8, 2017

neighborhood999 Nov 8, 2017

neighborhood999 commented Nov 9, 2017

Nationalcat commented Nov 9, 2017

neighborhood999 Nov 9, 2017


		The Laravel service container is a powerful tool for managing class dependencies and performing dependency injection. Dependency injection is a fancy phrase that essentially means this: class dependencies are "injected" into the class via the constructor or, in some cases, "setter" methods.
		Laravel 服務容器（Container）是管理類別依賴與執行依賴注入的強大工具。依賴注入是個花俏的名詞，實際上是指：類別的依賴透過建構子「注入」，或在某些情況下透過「setter」方法注入。


		A deep understanding of the Laravel service container is essential to building a powerful, large application, as well as for contributing to the Laravel core itself.
		深入地理解 Laravel 服務容器，對於構建功能強大的大型 Laravel 應用程式而言至關重要。甚至是貢獻 Laravel 核心的程式碼也是不可或缺的。


		Almost all of your service container bindings will be registered within [service providers](/docs/{{version}}/providers), so most of these examples will demonstrate using the container in that context.
		幾乎所有的服務容器綁定都會在[服務提供者](/docs/{{version}}/providers)中註冊，所以下方所有的例子將示範在該情境中使用容器。


		For example, you may type-hint a repository defined by your application in a controller's constructor. The repository will automatically be resolved and injected into the class:
		舉個例子，你可以在控制器的建構子中對應用程式中定義的儲存庫進行型別提示。儲存庫會自動被解析及注入至類別中：

		@@ -251,12 +251,12 @@ The service container fires an event each time it resolves an object. You may li
		// Called when container resolves objects of type "HelpSpot\API"...

Translate container.md (v5.5) #357

Translate container.md (v5.5) #357

Conversation

Nationalcat commented Oct 23, 2017