Khác biệt

Đây là những khác biệt giữa hai phiên bản của trang.

--- programming:rule [2016/06/16 10:47] – [function, class] hoaquynhtim99
+++ programming:rule [2016/06/16 11:01] – [Sử dụng phpDesigner 8] hoaquynhtim99
@@ Dòng 52: / Dòng 52: @@
 ===== Chuẩn định dạng các file PHP =====
+NukeViet áp dụng chuẩn định dạng code [[http://www.php-fig.org/psr/psr-2/|PSR-2]], mọi quy các áp dụng có thể xem tại đó.
+Xem bản dịch Tiếng Việt của tài liệu trên: https://github.com/nukeviet/fig-standards/blob/master/accepted/vi/PSR-2-coding-style-guide.md
 ===== Array =====
+Do chuẩn PSR-2 không có quy định cụ thể về cách viết array, do đó NukeViet áp dụng riêng chuẩn như sau:
 Nếu mảng ngắn từ một đến hai phần tử ta viết
-<code php>$array = array( 'id' => $id, 'title' => $title );</code>
+<code php>$array = array('id' => $id, 'title' => $title);</code>
 Nếu dài hơn ta phải viết
 <code php>
 $array = array(
-	'id' => $id,
+    'id' => $id,
-	'title' => $title
+    'title' => $title
 );
 </code>
@@ Dòng 67: / Dòng 71: @@
 <code php>
 $array = array(
-	'id' => array(
+    'id' => array(
-		'id' => $_id,
+        'id' => $_id,
-		'content' => array(
+            'content' => array(
-			'sub' => $sub,
+                'sub' => $sub,
-			'cat' => $cat
+                'cat' => $cat
-		),
+            ),
-	),
+        ),
-	'title' => $title
+        'title' => $title
 );
 </code>
@@ Dòng 80: / Dòng 84: @@
-===== Ghi chú (comment) =====
-Khi thiết kế CSDL, cần thêm ghi chú cho mỗi trường dữ liệu.
-Trong tập tin code, để đúng chuẩn cần viết ghi chú ngắn gọn cho mỗi dòng bằng <code>//</code> và không dùng <code>/* */</code> hay <code>#</code>
-Ví dụ: Dùng <code>// Ghi chú</code>
-Không dùng <code># Ghi chú</code>
-Không dùng <code>/* Ghi chú */</code>
 ====== Đối với các file JS ======
-Áp dụng chuẩn của các file php
+Áp dụng chuẩn viết tương tự php
-Bắt đầu bởi mô tả:
-<code javascript>
-/* *
- * @Project NUKEVIET 3.0
- * @Author VINADES., JSC ( contact@vinades.vn )
- * @Copyright ( C ) 2010 VINADES., JSC. All rights reserved
- * @License GNU/GPL version 2 or any later version
- * @Createdate 1 - 31 - 2010 5 : 12
- */
-</code>
-Đặt { ngay sau các lệnh.
-<code javascript>
-if( a == 0 ) {
-	a = 1;
-}
-</code>
-Đặt else if ngay sau kí tự }
-<code javascript>
-if( a == 0 ){
-	a = 1;
-} else if ( a == -1 ) {
-	break;
-}
-</code>
-Các file javascript trong thư mục ''/modules/ten-module/js/'' không nên dùng thư viện Jquery mà chỉ được viết bởi các hàm, thư viện có sẵn của NukeViet.
 ====== Đối với các file TPL ======
 Nếu không có trường hợp đặc biệt nên dùng duy nhất một tên main để dánh dấu khối
@@ Dòng 137: / Dòng 106: @@
 </code>
-> Các file TPL thực chất chứa mã HTML, JS tương tự các file .html, cần dùng tab để đánh dấu các thẻ cha con:
+> Các file TPL thực chất chứa mã HTML, JS tương tự các file .html, cần dùng 4 ký tự space để đánh dấu các thẻ cha con:
 <code html>
 <!-- BEGIN: main -->
@@ Dòng 178: / Dòng 147: @@
 <code css>
 .banner_plan {
-	background: #FFF;
+    background: #FFF;
-	border: 1px solid #DADADA;
+    border: 1px solid #DADADA;
-	margin-bottom: 10px;
+    margin-bottom: 10px;
-	padding: 5px
+    padding: 5px
 }
 </code>
@@ Dòng 219: / Dòng 188: @@
 Để định dạng code NukeViet trên phpDesigner 8 bạn cầu hình fomat file php như sau:
-{{ :programming:formatcodephpdj.jpg?nolink |}}
+{{ :programming:chuan_code_psr-2.png |Cấu hình định dạng code PSR-2 cho PhpDesigner 8}}
-Sau đó clich vào menu Advanced... Cấu hình theo thông số sau
+Sau khi lưu cấu hình, bạn mở từng file cần định dạng và nhấn tổ hợp phím Shift + Ctrl + F1
-{{ :programming:phpdesigner_8_fomatcode.jpg?nolink |}}
+> **Chú ý**: PhpDesigner không định dạng tương tích hoàn toàn với chuẩn PSR-2 nên sau khi định dạng code theo trên, bạn cần thực hiện thêm hai thao tác nữa để có thể hoàn toàn áp dụng đúng chuẩn.
-Sau khi lưu cấu hình, bạn mở từng file cần định dạng và nhấn tổ hợp phím Shift + Ctrl + F1
+  - Tại các file vừa định dạng, tìm kiếm cụm từ ''Catch ('' nếu có, đưa nó lên ngang hàng với ký tự ''}''
+  - Tìm kiếm ''array('' và ''array ('' nếu có kiểm tra lại và đưa ký tự đóng '')'' xuống hàng mới.