Skip to content

Commit 1a1edd1

Browse files
committed
修正翻譯 組件=>元件,部分控制器補充翻譯
1 parent 19cb2db commit 1a1edd1

12 files changed

Lines changed: 30 additions & 34 deletions

File tree

source/concepts/autoloader.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66

77
CodeIgniter 提供了一個非常靈活且極少需要設定的自動載入器。它可以定位單個非命名空間標註的類別、符合 `PSR4 <http://www.php-fig.org/psr/psr-4/>`_ 的命名空間規範目錄加載結構的類別,甚至可以在常規目錄下定位類別檔案(例如 Controller、Model等)。
88

9-
為了提升效能,CodeIgniter的核心組件已被添加到類別映射檔案中
9+
為了提升效能,CodeIgniter的核心元件已被添加到類別映射檔案中
1010

1111
自動載入器可以獨立運行,但如果你需要的話,也可以和其他自動載入器協同運行,例如 `Composer <https://getcomposer.org>`_ 或者是你自己的自定義載入器。因為它們都是透過 `spl_autoload_register <http://php.net/manual/en/function.spl-autoload-register.php>`_ 來註冊運行的,所以可以依次運行,互不干擾。
1212

source/concepts/mvc.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
模型、視圖與控制器
33
##############################
44

5-
當創建一個應用程式的時候,我們需要有一種便捷且可以簡易組織代碼的架構。和很多 web 框架類似, CodeIgniter 框架也使用了模型、視圖以及控制器的架構,即 MVC 模式。這種方式可以將資料、畫面和流程等部分,分別作為單獨的組件存放在我們的應用程式中。需要特別注意的是,可能每個人會對某個組件所擔任的角色有不同的看法,那麼,下面我們就透過這個文檔來說明這些組件所擔任的角色,如果你有不同的想法,你可以依照你的需求自由決定如何使用這些組件
5+
當創建一個應用程式的時候,我們需要有一種便捷且可以簡易組織代碼的架構。和很多 web 框架類似, CodeIgniter 框架也使用了模型、視圖以及控制器的架構,即 MVC 模式。這種方式可以將資料、畫面和流程等部分,分別作為單獨的元件存放在我們的應用程式中。需要特別注意的是,可能每個人會對某個元件所擔任的角色有不同的看法,那麼,下面我們就透過這個文檔來說明這些元件所擔任的角色,如果你有不同的想法,你可以依照你的需求自由決定如何使用這些元件
66

77
**模型** 主要用來管理應用程式的資料,以及幫助應用程式執行特殊的業務規則。
88

@@ -12,10 +12,10 @@
1212

1313
在最一般的狀況下,控制器和模型 只是一個完成特定工作的類別。它們雖然不是你唯一可以使用的類別類型,但它們是構成整個框架的核心。我們在框架中指定 **/app** 資料夾來儲存他們,但你只要將他們正確地放進命名空間中,你也可以儲存在任何你想要的位置,我們稍後會更加詳細的討論。
1414

15-
下面我們就來一一地仔細看一下這三個主要的組件
15+
下面我們就來一一地仔細看一下這三個主要的元件
1616

1717
**************
18-
組件
18+
元件
1919
**************
2020

2121
視圖

source/extending/basecontroller.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
擴充控制器
33
************************
44

5-
CodeIgniter 的核心控制器不應該被改變,但是在 **app/Controllers/BaseController.php** 中,我們為你提供了一個預設的控制器擴充類別。你所製作的任何控制器都應該繼承 ``BaseController`` 來利用預載組件以及你提供的任何額外功能
5+
CodeIgniter 的核心控制器不應該被改變,但是在 **app/Controllers/BaseController.php** 中,我們為你提供了一個預設的控制器擴充類別。你所製作的任何控制器都應該繼承 ``BaseController`` 來利用預載元件以及你提供的任何額外功能
66

77
::
88

@@ -18,7 +18,7 @@ CodeIgniter 的核心控制器不應該被改變,但是在 **app/Controllers/B
1818
}
1919

2020

21-
預載組件
21+
預載元件
2222
=====================
2323

2424
基本控制器是一個好地方,可以在每次專案運作時載入任何輔助函數、模型、程式庫,以及服務等。輔助函數應該被加入到預先定義好的 ``$helpers`` 陣列中。例如:你想讓 HTML 以及文字輔助函數普遍可用:
@@ -27,7 +27,7 @@ CodeIgniter 的核心控制器不應該被改變,但是在 **app/Controllers/B
2727

2828
protected $helpers = ['html', 'text'];
2929

30-
任何需要載入的組件或需要處理的資料都應該加入到建構函數 ``initController()`` 中。例如:你的專案大量使用到會談程式庫,你可以會需要在這裡啟動它:
30+
任何需要載入的元件或需要處理的資料都應該加入到建構函數 ``initController()`` 中。例如:你的專案大量使用到會談程式庫,你可以會需要在這裡啟動它:
3131

3232
::
3333

source/general/logging.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ info 在你的應用程式中發生的重大事件,例如:使用者
2424
notice 你的應用程式運作正常但必須記錄的重要事件。
2525
warning 發生了不屬於錯誤的異常情形,比如說:使用了被淘汰的 API 、不當地使用 API ,或其他不一定是錯誤地不良情況。
2626
error 不需要立即採取行動,但應該要被記錄和監測的執行期間錯誤。
27-
critical 關鍵情況,如應用程式組件無法使用,或是出現意外異常。
27+
critical 關鍵情況,如應用程式元件無法使用,或是出現意外異常。
2828
alert 必須立即採取行動,比如整個網站癱瘓,或是資料庫無法使用等等。
2929
emergency 系統無法使用。
3030
=========== ==================================================================

source/general/managing_apps.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,4 +57,4 @@
5757

5858
每個應用程式內的 ``index.php`` 都會引用自己的設定,即 ``.../app/Config/Paths.php`` 。而每個應用程式內的 ``$systemDirectory`` 變數會被設定為共用 "system" 資料夾。
5959

60-
如果有任何一個應用程式擁有命令列組件,那麼你也可以參閱上個的條目提到的方法,在該應用程式的專案資料夾內修改 spark 。
60+
如果有任何一個應用程式擁有命令列元件,那麼你也可以參閱上個的條目提到的方法,在該應用程式的專案資料夾內修改 spark 。

source/incoming/controllers.rst

Lines changed: 11 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -30,11 +30,11 @@
3030

3131
讓我們創建一個簡單的控制器,這樣你就可以看到它的操作方式。使用你的文本編輯器,創建一個名為 Helloworld.php 的文件,然後把下面的程式碼放在裡面。
3232

33-
You will notice that the Helloworld Controller is extending the BaseController. you can also extend the CodeIgniter\Controller if you do not need the functionality of the BaseController.
33+
你會注意到 Helloworld 控制器繼承了 BaseController ,如果你不需要 BaseController 提供的功能,你也可以直接繼承 ``CodeIgniter\Controller`` 。
3434

35-
The BaseController provides a convenient place for loading components and performing functions that are needed by all your controllers. You can extend this class in any new controller.
35+
BaseController 替載入元件以及執行所有控制器都需要的功能提供了一個好地方,你可以在任何新的控制器中繼承這個類別。
3636

37-
For security reasons be sure to declare any new utility methods as protected or private.:
37+
為了安全起見,請以保護或私有宣告新的方法。
3838

3939
::
4040

@@ -109,16 +109,14 @@ For security reasons be sure to declare any new utility methods as protected or
109109

110110
}
111111

112-
另外,一定要確保你的控制器擴展了父控制器類別,這樣它才可以繼承所有的方法。
112+
另外,一定要確保你的控制器繼承了父控制器類別,這樣它才可以繼承所有的方法。
113113

114114
.. note::
115-
The system will attempt to match the URI against Controllers by matching each segment against
116-
folders/files in APPPATH/Controllers, when a match wasn't found against defined routes.
117-
That's why your folders/files MUST start with a capital letter and the rest MUST be lowercase.
118-
If you want another naming convention you need to manually define it using the
119-
:doc:`URI Routing <routing>` feature.
115+
當未找到與你所宣告的路由相配對的項目時,系統將會嘗試透過將每個區段與 ``APPPATH/Controllers`` 中的資料夾/檔案進行配對來找到合適的控制器。這就是為什麼資料夾以及檔案必須大寫字母開頭,其餘部分皆是小寫的原因。如果你需要其他的命名方式,則需要使用 :doc:`URI 路由 <routing>` 功能手動宣告。
120116

121-
Here is an example based on PSR-4: Autoloader::
117+
以下是基於 PSR-4 的範例:自動載入器
118+
119+
::
122120

123121
\<NamespaceName>(\<SubNamespaceNames>)*\<ClassName>
124122

@@ -291,7 +289,7 @@ $routes->get('/', 'Home::index');
291289

292290
只需在主要的 *app/Controllers/* 目錄下創建子目錄,然後將你的控制器類別放進去。
293291

294-
.. important:: Folder names MUST start with an uppercase letter and ONLY the first character can be uppercase.
292+
.. important:: 資料夾名稱必須以大寫字母開頭,並且只有第一個字元可以大寫。
295293

296294
.. note:: 使用此功能時,URI的第一段必須要指定資料夾。例如,假設你有一個控制器位於這裡:
297295

@@ -312,7 +310,7 @@ CodeIgniter 還允許你使用 :doc:`URI Routing <routing>` 功能重新映射
312310
擁有的屬性
313311
===================
314312

315-
你創建的每個控制器都應該擴展 ``CodeIgniter\Controller`` 類別。這個類別提供了幾個功能,所有的控制器都可以使用。
313+
你創建的每個控制器都應該繼承 ``CodeIgniter\Controller`` 類別。這個類別提供了幾個功能,所有的控制器都可以使用。
316314

317315
**請求物件**
318316

@@ -394,9 +392,7 @@ CodeIgniter 還允許你使用 :doc:`URI Routing <routing>` 功能重新映射
394392
// do something here if successful...
395393
}
396394

397-
驗證也可以在模型中自動處理,但有時在控制器中進行驗證會更方便。具體到哪裡,由你自己決定.
398-
399-
.. note:: Validation can also be handled automatically in the model, but sometimes it's easier to do it in the controller. Where is up to you.
395+
.. note:: 驗證也可以在模型中自動處理,但有時在控制器中進行驗證會更方便。具體在哪裡執行,由你自己決定.
400396

401397
就是這樣!
402398
==========

source/incoming/restful.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -80,7 +80,7 @@ CodeIgniter 透過它的資源路由和 `ResourceController`,可以讓你的
8080

8181
`ResourceController` 為你的 RESTful API 提供了一個方便的進入點,它有著與上述資源路由相對應的方法。
8282

83-
擴展它,覆蓋 `modelName` 和 `format` 屬性,然後實作你想使用的方法::
83+
繼承它,覆蓋 `modelName` 和 `format` 屬性,然後實作你想使用的方法::
8484

8585
<?php namespace App\Controllers;
8686

source/installation/upgrade_4xx.rst

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ CodeIgniter 4 是一個完全重寫的框架,它不具備向後相容的特性
77
與 CodeIgniter 3 相比,保持了「精益、平衡、簡單」的理念,但實踐上卻存在著很大的區別。
88

99
在升級的工作上,並沒有類似於「十二步驟」的檢查表。相反的,你必須利用
10-
:doc:`安裝指引 </installation/index>` 在新的專案資料夾中取得全新的 CodeIgniter 4 ,接著再開始轉換整合你的應用組件,我們將指出你可能會需要考慮的因素。
10+
:doc:`安裝指引 </installation/index>` 在新的專案資料夾中取得全新的 CodeIgniter 4 ,接著再開始轉換整合你的應用元件,我們將指出你可能會需要考慮的因素。
1111

1212
並不是所有的 CI3 程式庫都移植或重構成 CI4 版本!關於最新的支援清單,你可以參閱 `CodeIgniter 4 路線圖 <https://forum.codeigniter.com/forum-33.html>`_ 論壇分類中的 up-to-date 文章。
1313

@@ -48,9 +48,9 @@ CodeIgniter 4 是一個完全重寫的框架,它不具備向後相容的特性
4848

4949
**類別載入**
5050

51-
- 不再有 CodeIgniter「超級物件」 的存在,框架組件的將會作為屬性,動態載入至控制器之中。
51+
- 不再有 CodeIgniter「超級物件」 的存在,框架元件的將會作為屬性,動態載入至控制器之中。
5252

53-
- 類別只在需要它的地方才進行實作,組件統一由 ``Services`` 進行管理。
53+
- 類別只在需要它的地方才進行實作,元件統一由 ``Services`` 進行管理。
5454

5555
- 類別載入器將自動以 PSR4 的規則,在 ``App`` (應用程式)和 ``CodeIgniter`` (系統)這兩個頂級命名空間進行類別定位;支援 Composer 自動載入,甚至是類別檔案在沒有宣告命名空間的情形下,也可以透過假設的方式,根據它們位於的文件夾,找到正確的模型與程式庫。
5656

@@ -60,7 +60,7 @@ CodeIgniter 4 是一個完全重寫的框架,它不具備向後相容的特性
6060

6161
- 你的應用程式類別依然可以載入在 ``app/Libraries`` 之中的類別,但這些類別也可以儲存在別處。
6262

63-
- CI3 的 ``$this->load->library(x);`` 已棄用。現在,在你所想要使用的組件內,你可以按照命名空間的定義,使用 ``$this->x = new X();`` 實作你想使用的程式庫類別。
63+
- CI3 的 ``$this->load->library(x);`` 已棄用。現在,在你所想要使用的元件內,你可以按照命名空間的定義,使用 ``$this->x = new X();`` 實作你想使用的程式庫類別。
6464

6565
**輔助函數**
6666

@@ -80,7 +80,7 @@ CodeIgniter 4 是一個完全重寫的框架,它不具備向後相容的特性
8080

8181
- 在程式庫資料夾下,某些類別用於繼承或取代框架中原有的功能。現在,你不再需要以 ``MY_x`` 來命名。
8282

83-
- 你可以在任何需要的地方創建這個類別,只需要在 ``app/Config/Services.php`` 中添加合適服務方法( service methods ),來替換掉預設組件
83+
- 你可以在任何需要的地方創建這個類別,只需要在 ``app/Config/Services.php`` 中添加合適服務方法( service methods ),來替換掉預設元件
8484

8585
Upgrading Libraries
8686
===================

source/intro/index.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
CodeIgniter 是一套給予 PHP 網站工程師使用的應用程式開發框架。你可以利用簡單的邏輯介面操作 CodeIgniter 所提供的豐富程式庫,在碰到常見的需求時,比從頭造輪子更加敏捷。使用 CodeIgniter 能以最少的程式碼達到所需要的功能。
66

7-
CodeIgniter 將最大限度地保持「靈活」的特色,你可以用你喜歡的方式撰寫程式,而不是被條條框框的規則所束縛。框架可以輕鬆地擴充或替換核心組件,讓專案可以按你所想地運作。總地來說, CodeIgniter 是一個可以擴充的框架,它將在不影響開發為前提提供你所需的工具。
7+
CodeIgniter 將最大限度地保持「靈活」的特色,你可以用你喜歡的方式撰寫程式,而不是被條條框框的規則所束縛。框架可以輕鬆地擴充或替換核心元件,讓專案可以按你所想地運作。總地來說, CodeIgniter 是一個可以擴充的框架,它將在不影響開發為前提提供你所需的工具。
88

99
***********************
1010
CodeIgniter 適合誰?

source/libraries/encryption.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -223,7 +223,7 @@ HMAC-SHA512 for the authentication.
223223
// reconfigure an instance with different settings
224224
$encrypter = $encryption->initialize($config);
225225

226-
記住, ``$config`` 必須是 `Config\Encryption` 類別的實體或擴展 `CodeIgniter\Config\BaseConfig` 。
226+
記住, ``$config`` 必須是 `Config\Encryption` 類別的實體或繼承 `CodeIgniter\Config\BaseConfig` 。
227227

228228

229229
***************

0 commit comments

Comments
 (0)