Hướng dẫn php router github - php router github

simple-router

Bộ định tuyến PHP đơn giản, nhanh chóng và mạnh mẽ, dễ dàng được tích hợp và trong bất kỳ dự án nào. Lấy cảm hứng nhiều từ cách Laravel xử lý định tuyến, với cả sự đơn giản và khả năng mở rộng trong tâm trí.

Với bộ định tuyến đơn giản, bạn có thể tạo một dự án mới nhanh chóng, mà không phụ thuộc vào khung.

Nó chỉ mất một vài dòng mã để bắt đầu:

SimpleRouter::get('/', function() {
    return 'Hello world';
});

Hỗ trợ dự án

Nếu bạn thích bộ định tuyến đơn giản và muốn xem sự phát triển và bảo trì tiếp tục của dự án, vui lòng xem xét hiển thị hỗ trợ của bạn bằng cách mua cho tôi một ly cà phê. Những người ủng hộ sẽ được liệt kê trong phần tín dụng của tài liệu này.

Bạn có thể quyên góp bất kỳ số tiền bạn chọn bằng cách nhấp vào đây.

Mục lục

• Bắt đầu
  • Ghi chú
  • Yêu cầu
  • Đặc trưng
  • Cài đặt
    • Thiết lập Apache
    • Thiết lập nginx
    • Thiết lập IIS
    • Cấu hình
    • Chức năng trợ giúp
• Tuyến đường
  • Định tuyến cơ bản
    • Lớp gợi ý
    • Phương pháp có sẵn
    • Nhiều http-verbs
  • Tham số tuyến đường
    • Tham số cần thiết
    • Tham số tùy chọn
    • Các ràng buộc biểu thức chính quy
    • Trò chơi biểu thức thường xuyên
    • Tùy chỉnh regex cho các tham số phù hợp
  • Các tuyến đường được đặt tên
    • Tạo URL cho các tuyến đường được đặt tên
  • Nhóm bộ định tuyến
    • Phần mềm trung gian
    • Không gian tên
    • Subdomain-routing
    • Tiền tố định tuyến
  • Nhóm một phần
  • Hình thức giả mạo phương pháp
  • Truy cập tuyến đường hiện tại
  • Những ví dụ khác
• CSRF-protection
  • Thêm CSRF-Verifier
  • Nhận CSRF-Token
  • CSRF-Verifier tùy chỉnh
  • Mã thông báo tùy chỉnh
• Middle Wares
  • Thí dụ
• Ngoại lệ
  • Xử lý 404, 403 và các lỗi khác
  • Sử dụng trình xử lý ngoại lệ tùy chỉnh
    • Ngăn chặn sự hợp nhất của người làm việc ngoại lệ phụ huynh
• URL
  • Nhận URL hiện tại
  • Nhận theo tên (tuyến đường đơn)
  • Nhận theo tên (tuyến điều khiển)
  • Nhận theo lớp
  • Sử dụng tên tùy chỉnh cho các phương thức trên tuyến điều khiển/tài nguyên
  • Nhận URL Bộ điều khiển REST/Tài nguyên
  • Thao tác URL
  • Thủ thuật URL hữu ích
• Đầu vào & tham số
  • Sử dụng lớp đầu vào để quản lý các tham số
    • Nhận giá trị tham số đơn
    • Nhận đối tượng tham số
    • Quản lý tập tin
    • Nhận tất cả các tham số
    • Kiểm tra xem các tham số có tồn tại không
• Sự kiện
  • Các sự kiện có sẵn
  • Đăng ký sự kiện mới
  • Sự kiện tùy chỉnh
• Nâng cao
  • Tắt nhiều tuyến đường
  • Hạn chế quyền truy cập vào IP
  • Đặt đường dẫn cơ sở tùy chỉnh
  • Viết lại URL
    • Thay đổi tuyến đường hiện tại
    • BootManager: Đang tải các tuyến đường động
    • Thêm các tuyến đường bằng tay
  • Người tải lớp tùy chỉnh
    • Tích hợp với PHP-di
  • Thông số
  • Mở rộng
• Giúp đỡ và hỗ trợ
  • Các vấn đề và sửa chữa phổ biến
    • Nhiều tuyến đường phù hợp? Cái nào có ưu tiên?
    • Tham số sẽ không khớp hoặc tuyến không hoạt động với các ký tự đặc biệt
    • Sử dụng bộ định tuyến trên các con đường phụ
  • Gỡ lỗi
    • Tạo các bài kiểm tra đơn vị
    • Thông tin gỡ lỗi
    • Điểm chuẩn và log-info
  • Báo cáo một vấn đề mới
    • Thủ tục báo cáo một vấn đề mới
    • Mẫu phát hành
  • Phản hồi và phát triển
    • Hướng dẫn phát triển đóng góp
• Tín dụng
  • Trang web
  • Giấy phép

Bắt đầu

Thêm phiên bản mới nhất của dự án bộ định tuyến đơn giản chạy lệnh này.

composer require pecee/simple-router

Ghi chú

Mục tiêu của dự án này là tạo ra một bộ định tuyến tương thích 100% với tài liệu Laravel, trong khi vẫn đơn giản nhất có thể, và dễ dàng tích hợp và thay đổi mà không ảnh hưởng đến tốc độ hoặc độ phức tạp. Nhẹ là ưu tiên số 1.

Chúng tôi đã bao gồm một dự án demo đơn giản cho bộ định tuyến có thể được tìm thấy ở đây. Dự án này sẽ cung cấp cho bạn một sự hiểu biết cơ bản về cách thiết lập và sử dụng dự án bộ định tuyến đơn giản.

Xin lưu ý rằng dự án demo chỉ bao gồm cách tích hợp

/index.php/test/mypage.php

Bạn có thể tìm thấy bản demo-Project ở đây: https://github.com/skipperbent/simple-louter-demo

Những gì chúng tôi sẽ không bao gồm:

• Làm thế nào để thiết lập một giải pháp phù hợp với nhu cầu của bạn. Đây là một bản demo cơ bản để giúp bạn bắt đầu.
• Sự hiểu biết về MVC; bao gồm bộ điều khiển, đường giữa hoặc ngoại lệ.
• Làm thế nào để tích hợp vào các khung của bên thứ ba.

Những gì chúng tôi bao gồm:

• Làm thế nào để đứng dậy và chạy nhanh - từ đầu.
• Làm thế nào để có được các trình ngoại lệ, các trung bình và bộ điều khiển hoạt động.
• Làm thế nào để thiết lập máy chủ web của bạn.

Yêu cầu

• Php 7.1 trở lên (Phiên bản 3.x trở xuống hỗ trợ Php 5.5+)
• Phần mở rộng PHP JSON được bật.

Đặc trưng

• Định tuyến cơ bản (

  /index.php/test/mypage.php
  

  5,

  /index.php/test/mypage.php
  

  6,

  /index.php/test/mypage.php
  

  7,

  /index.php/test/mypage.php
  

  8,

  /index.php/test/mypage.php
  

  9,

  
  use Pecee\SimpleRouter\SimpleRouter;
  
  /* Load external routes file */
  require_once 'routes.php';
  
  /**
   * The default namespace for route-callbacks, so we don't have to specify it each time.
   * Can be overwritten by using the namespace config option on your routes.
   */
  
  SimpleRouter::setDefaultNamespace('\Demo\Controllers');
  
  // Start the routing
  SimpleRouter::start();

  0) với sự hỗ trợ cho nhiều động từ tùy chỉnh.
• Các ràng buộc biểu thức chính quy cho các tham số.
• Các tuyến đường được đặt tên.
• Tạo URL đến các tuyến đường.
• Nhóm tuyến đường.
• Phần mềm trung gian (các lớp chặn trước khi tuyến được hiển thị).
• Namespaces.
• Tiền tố định tuyến.
• Bảo vệ CSRF.
• Tham số tùy chọn
• Các ràng buộc biểu thức chính quy
• Trò chơi biểu thức thường xuyên
• Tùy chỉnh regex cho các tham số phù hợp
• Các tuyến đường được đặt tên
• Tạo URL cho các tuyến đường được đặt tên

Cài đặt

1. Nhóm bộ định tuyến

composer require pecee/simple-router

Thiết lập nginx

Nếu bạn đang sử dụng Nginx, vui lòng đảm bảo rằng việc viết URL được bật.

Bạn có thể dễ dàng kích hoạt việc viết URL bằng cách thêm cấu hình sau cho tệp cấu hình NGINX cho dự án demo.

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Thiết lập Apache

Không có gì đặc biệt là cần thiết để Apache hoạt động. Chúng tôi đã bao gồm tệp

use Pecee\SimpleRouter\SimpleRouter;

/* Load external routes file */
require_once 'routes.php';

/**
 * The default namespace for route-callbacks, so we don't have to specify it each time.
 * Can be overwritten by using the namespace config option on your routes.
 */

SimpleRouter::setDefaultNamespace('\Demo\Controllers');

// Start the routing
SimpleRouter::start();

use Pecee\SimpleRouter\SimpleRouter;

/* Load external routes file */
require_once 'routes.php';

/**
 * The default namespace for route-callbacks, so we don't have to specify it each time.
 * Can be overwritten by using the namespace config option on your routes.
 */

SimpleRouter::setDefaultNamespace('\Demo\Controllers');

// Start the routing
SimpleRouter::start();

use Pecee\SimpleRouter\SimpleRouter;

/* Load external routes file */
require_once 'routes.php';

/**
 * The default namespace for route-callbacks, so we don't have to specify it each time.
 * Can be overwritten by using the namespace config option on your routes.
 */

SimpleRouter::setDefaultNamespace('\Demo\Controllers');

// Start the routing
SimpleRouter::start();

Ví dụ .htaccess

Dưới đây là một ví dụ về tệp

use Pecee\SimpleRouter\SimpleRouter;

/* Load external routes file */
require_once 'routes.php';

/**
 * The default namespace for route-callbacks, so we don't have to specify it each time.
 * Can be overwritten by using the namespace config option on your routes.
 */

SimpleRouter::setDefaultNamespace('\Demo\Controllers');

// Start the routing
SimpleRouter::start();

Chỉ cần tạo một tệp

use Pecee\SimpleRouter\SimpleRouter;

/* Load external routes file */
require_once 'routes.php';

/**
 * The default namespace for route-callbacks, so we don't have to specify it each time.
 * Can be overwritten by using the namespace config option on your routes.
 */

SimpleRouter::setDefaultNamespace('\Demo\Controllers');

// Start the routing
SimpleRouter::start();

use Pecee\SimpleRouter\SimpleRouter;

/* Load external routes file */
require_once 'routes.php';

/**
 * The default namespace for route-callbacks, so we don't have to specify it each time.
 * Can be overwritten by using the namespace config option on your routes.
 */

SimpleRouter::setDefaultNamespace('\Demo\Controllers');

// Start the routing
SimpleRouter::start();

composer require pecee/simple-router

RewriteEngine on
RewriteCond %{SCRIPT_FILENAME} !-f
RewriteCond %{SCRIPT_FILENAME} !-d
RewriteCond %{SCRIPT_FILENAME} !-l
RewriteRule ^(.*)$ index.php/$1

Thiết lập IIS

Trên IIS, bạn phải thêm một số dòng tệp

composer require pecee/simple-router

use Pecee\SimpleRouter\SimpleRouter;

/* Load external routes file */
require_once 'routes.php';

/**
 * The default namespace for route-callbacks, so we don't have to specify it each time.
 * Can be overwritten by using the namespace config option on your routes.
 */

SimpleRouter::setDefaultNamespace('\Demo\Controllers');

// Start the routing
SimpleRouter::start();

composer require pecee/simple-router

Ví dụ Web.Config

Dưới đây là một ví dụ về tệp

composer require pecee/simple-router

Chỉ cần tạo một tệp

composer require pecee/simple-router

use Pecee\SimpleRouter\SimpleRouter;

/* Load external routes file */
require_once 'routes.php';

/**
 * The default namespace for route-callbacks, so we don't have to specify it each time.
 * Can be overwritten by using the namespace config option on your routes.
 */

SimpleRouter::setDefaultNamespace('\Demo\Controllers');

// Start the routing
SimpleRouter::start();

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
	<rewrite>
	  <rules>
		
		<rule name="RewriteRequestsToPublic">
		  <match url="^(.*)$" />
		  <conditions logicalGrouping="MatchAll" trackAllCaptures="false">
		  conditions>
		  <action type="Rewrite" url="/{R:0}" />
		rule>

		
		<rule name="Imported Rule 1" stopProcessing="true">
		  <match url="^(.*)$" ignoreCase="true" />
		  <conditions logicalGrouping="MatchAll">
			<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
			<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
		  conditions>
		  <action type="Rewrite" url="/index.php/{R:1}" appendQueryString="true" />
		rule>
	  rules>
	rewrite>
    system.webServer>
configuration>

Xử lý sự cố

Nếu bạn không có tệp

composer require pecee/simple-router

composer require pecee/simple-router

Để thêm

composer require pecee/simple-router

composer require pecee/simple-router

Bạn cũng có thể tạo một ngoại lệ cho các tệp có một số tiện ích mở rộng:

Nếu bạn đang sử dụng

composer require pecee/simple-router

composer require pecee/simple-router

Example:

/index.php/test/mypage.php

Cấu hình

Tạo một tệp mới, đặt tên cho nó

composer require pecee/simple-router

CẢNH BÁO: Không bao giờ đặt các tuyến đường của bạn.php trong thư mục công khai của bạn!

Trong

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

Không bắt buộc, nhưng bạn có thể đặt

composer require pecee/simple-router

Đây là một ví dụ về tệp

composer require pecee/simple-router

use Pecee\SimpleRouter\SimpleRouter;

/* Load external routes file */
require_once 'routes.php';

/**
 * The default namespace for route-callbacks, so we don't have to specify it each time.
 * Can be overwritten by using the namespace config option on your routes.
 */

SimpleRouter::setDefaultNamespace('\Demo\Controllers');

// Start the routing
SimpleRouter::start();

Chức năng trợ giúp

Chúng tôi khuyên bạn nên thêm các chức năng trợ giúp này vào dự án của bạn. Những điều này sẽ cho phép bạn truy cập chức năng của bộ định tuyến dễ dàng hơn.

Để thực hiện các chức năng bên dưới, chỉ cần sao chép mã vào một tệp mới và yêu cầu tệp trước khi khởi tạo bộ định tuyến hoặc sao chép

composer require pecee/simple-router

composer require pecee/simple-router

Tuyến đường

Bạn có nhớ tệp

composer require pecee/simple-router

composer require pecee/simple-router

Định tuyến cơ bản

Dưới đây là một ví dụ rất cơ bản về việc thiết lập một tuyến đường. Tham số đầu tiên là URL mà tuyến sẽ khớp - tham số tiếp theo là hàm

composer require pecee/simple-router

SimpleRouter::get('/', function() {
    return 'Hello world';
});

Lớp gợi ý

Bạn có thể sử dụng gợi ý lớp để tải một lớp & phương thức như thế này:

composer require pecee/simple-router

Phương pháp có sẵn

Ở đây bạn có thể thấy một danh sách trên tất cả các tuyến có sẵn:

composer require pecee/simple-router

Nhiều http-verbs

Đôi khi bạn có thể cần tạo một tuyến đường chấp nhận nhiều http-verbs. Nếu bạn cần phù hợp với tất cả các bản verbs HTTP, bạn có thể sử dụng phương thức

composer require pecee/simple-router

composer require pecee/simple-router

Chúng tôi đã tạo một phương thức đơn giản phù hợp với

/index.php/test/mypage.php

/index.php/test/mypage.php

composer require pecee/simple-router

Tham số tuyến đường

Tham số cần thiết

Bạn sẽ tự hỏi đúng cách biết làm thế nào bạn phân tích các tham số từ URL của bạn. Ví dụ: bạn có thể muốn chụp ID người dùng từ URL. Bạn có thể làm như vậy bằng cách xác định tham số tuyến đường.

composer require pecee/simple-router

Bạn có thể xác định càng nhiều tham số tuyến theo yêu cầu của tuyến đường của bạn:

composer require pecee/simple-router

Lưu ý: Các tham số tuyến luôn được bao bọc trong vòng niềng răng

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

Tham số tùy chọn

Thỉnh thoảng bạn có thể cần chỉ định một tham số tuyến đường, nhưng làm cho sự hiện diện của tham số tuyến đó tùy chọn. Bạn có thể làm như vậy bằng cách đặt một? Đánh dấu sau tên tham số. Đảm bảo cung cấp cho biến tương ứng của tuyến một giá trị mặc định:

composer require pecee/simple-router

Các ràng buộc biểu thức chính quy

Bạn có thể hạn chế định dạng của các tham số tuyến của mình bằng cách sử dụng phương thức ở trường hợp tuyến đường. Phương thức nơi chấp nhận tên của tham số và biểu thức chính quy xác định cách bị hạn chế tham số:

composer require pecee/simple-router

Trò chơi biểu thức thường xuyên

Bạn có thể xác định một trận đấu biểu hiện thường xuyên cho toàn bộ tuyến nếu bạn muốn.

Điều này rất hữu ích nếu bạn ví dụ đang tạo một hộp mô hình tải URL từ AJAX.

Ví dụ dưới đây là sử dụng các biểu thức chính quy sau:

composer require pecee/simple-router

composer require pecee/simple-router

Trận đấu:

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

Sẽ không khớp:

composer require pecee/simple-router

composer require pecee/simple-router

Các nhóm khớp được chỉ định trong regex sẽ được truyền dưới dạng tham số:

composer require pecee/simple-router

Tùy chỉnh regex cho các tham số phù hợp

Theo mặc định đơn giản-Php-Router sử dụng biểu thức chính quy

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

Tuy nhiên, đôi khi có thể cần thêm một biểu thức thường xuyên tùy chỉnh để phù hợp với các ký tự nâng cao hơn như chữ cái nước ngoài

composer require pecee/simple-router

Bạn có thể kiểm tra biểu thức thông thường tùy chỉnh của mình bằng cách sử dụng trên trang web regex101.com.

Thay vì thêm một biểu thức thông thường tùy chỉnh vào tất cả các tham số của bạn, bạn chỉ cần thêm một biểu thức chính quy toàn cầu sẽ được sử dụng trên tất cả các tham số trên tuyến đường.

Lưu ý: Nếu bạn biểu thức thông thường có sẵn, chúng tôi khuyên bạn nên sử dụng tham số toàn cầu trên một nhóm như được trình bày trong các ví dụ dưới đây. If you the regular expression to be available across, we recommend using the global parameter on a group as demonstrated in the examples below.

Thí dụ

Ví dụ này sẽ đảm bảo rằng tất cả các tham số sử dụng

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

Bạn cũng có thể áp dụng cài đặt này cho một nhóm nếu bạn cần nhiều tuyến đường để sử dụng biểu thức thông thường tùy chỉnh của mình khi phân tích các tham số.

composer require pecee/simple-router

Các tuyến đường được đặt tên

Các tuyến được đặt tên cho phép tạo URL hoặc chuyển hướng thuận tiện cho các tuyến cụ thể. Bạn có thể chỉ định tên cho một tuyến đường bằng cách chuỗi phương thức tên vào định nghĩa tuyến đường:

composer require pecee/simple-router

Bạn cũng có thể chỉ định tên cho các hành động của bộ điều khiển:

composer require pecee/simple-router

Tạo URL cho các tuyến đường được đặt tên

Khi bạn đã gán một tên cho một tuyến đường nhất định, bạn có thể sử dụng tên của tuyến đường khi tạo URL hoặc chuyển hướng thông qua chức năng trợ giúp toàn cầu

composer require pecee/simple-router

composer require pecee/simple-router

Nếu tuyến được đặt tên xác định tham số, bạn có thể chuyển các tham số là đối số thứ hai cho hàm

composer require pecee/simple-router

composer require pecee/simple-router

Để biết thêm thông tin về URL, vui lòng xem phần URLS.

Nhóm bộ định tuyến

Các nhóm tuyến cho phép bạn chia sẻ các thuộc tính tuyến, chẳng hạn như phần mềm trung gian hoặc không gian tên, trên một số lượng lớn các tuyến đường mà không cần xác định các thuộc tính đó trên mỗi tuyến đường riêng lẻ. Các thuộc tính được chia sẻ được chỉ định ở định dạng mảng là tham số đầu tiên cho phương thức

composer require pecee/simple-router

Phần mềm trung gian

Để gán phần mềm trung gian cho tất cả các tuyến trong một nhóm, bạn có thể sử dụng khóa phần mềm trung gian trong mảng thuộc tính nhóm. Phần mềm trung gian được thực hiện theo thứ tự chúng được liệt kê trong mảng:

composer require pecee/simple-router

Không gian tên

Một trường hợp sử dụng phổ biến khác cho các nhóm tuyến đường là gán cùng một không gian tên PHP cho một nhóm bộ điều khiển bằng tham số

composer require pecee/simple-router

Ghi chú

Không gian tên nhóm sẽ chỉ được thêm vào các tuyến đường với các cuộc gọi lại tương đối. Ví dụ: nếu tuyến đường của bạn có một cuộc gọi lại tuyệt đối như

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

Bạn có thể thêm các tham số vào các tiền tố của các tuyến đường của bạn.

Các tham số từ các tuyến trước của bạn sẽ được đưa vào các tuyến đường của bạn sau khi bất kỳ tham số yêu cầu tuyến nào, bắt đầu từ lâu đời nhất đến mới nhất.

composer require pecee/simple-router

Subdomain-routing

Các nhóm tuyến cũng có thể được sử dụng để xử lý định tuyến tên miền phụ. Các miền phụ có thể được chỉ định các tham số tuyến giống như URL tuyến, cho phép bạn nắm bắt một phần của miền phụ để sử dụng trong tuyến đường hoặc bộ điều khiển của bạn. Miền phụ có thể được chỉ định bằng cách sử dụng khóa

composer require pecee/simple-router

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Tiền tố định tuyến

Thuộc tính nhóm

composer require pecee/simple-router

composer require pecee/simple-router

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Bạn cũng có thể sử dụng các tham số trong các nhóm của mình:

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Nhóm một phần

Các nhóm bộ định tuyến một phần có lợi ích giống như một nhóm bình thường, nhưng chỉ được hiển thị một khi URL phù hợp với một nhóm bình thường luôn được hiển thị để lấy các tuyến đường của trẻ. Do đó, các nhóm một phần giống như sự kết hợp của một tuyến đường truyền thống với lợi ích của một nhóm.are only rendered once the url has matched in contrast to a normal group which are always rendered in order to retrieve it's child routes. Partial groups are therefore more like a hybrid of a traditional route with the benefits of a group.

Điều này có thể cực kỳ hữu ích trong các tình huống mà bạn chỉ muốn thêm các tuyến đặc biệt, nhưng chỉ khi một tiêu chí hoặc logic nhất định đã được đáp ứng.

Lưu ý: Sử dụng các nhóm một phần thận trọng vì các tuyến đường được thêm vào chỉ được hiển thị và có sẵn một khi URL của nhóm một phần đã khớp. Điều này có thể gây ra

composer require pecee/simple-router

composer require pecee/simple-router

Example:

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Hình thức giả mạo phương pháp

Các biểu mẫu HTML không hỗ trợ các hành động

/index.php/test/mypage.php

/index.php/test/mypage.php

use Pecee\SimpleRouter\SimpleRouter;

/* Load external routes file */
require_once 'routes.php';

/**
 * The default namespace for route-callbacks, so we don't have to specify it each time.
 * Can be overwritten by using the namespace config option on your routes.
 */

SimpleRouter::setDefaultNamespace('\Demo\Controllers');

// Start the routing
SimpleRouter::start();

/index.php/test/mypage.php

/index.php/test/mypage.php

use Pecee\SimpleRouter\SimpleRouter;

/* Load external routes file */
require_once 'routes.php';

/**
 * The default namespace for route-callbacks, so we don't have to specify it each time.
 * Can be overwritten by using the namespace config option on your routes.
 */

SimpleRouter::setDefaultNamespace('\Demo\Controllers');

// Start the routing
SimpleRouter::start();

composer require pecee/simple-router

composer require pecee/simple-router

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Truy cập tuyến đường hiện tại

Bạn có thể truy cập thông tin về tuyến đường hiện tại được tải bằng cách sử dụng phương thức sau:

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Những ví dụ khác

Bạn có thể tìm thấy nhiều ví dụ khác trong tệp ví dụ

composer require pecee/simple-router

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Bảo vệ CSRF

Bất kỳ hình thức nào đăng lên các tuyến

/index.php/test/mypage.php

/index.php/test/mypage.php

use Pecee\SimpleRouter\SimpleRouter;

/* Load external routes file */
require_once 'routes.php';

/**
 * The default namespace for route-callbacks, so we don't have to specify it each time.
 * Can be overwritten by using the namespace config option on your routes.
 */

SimpleRouter::setDefaultNamespace('\Demo\Controllers');

// Start the routing
SimpleRouter::start();

Bạn có thể sử dụng

composer require pecee/simple-router

Theo mặc định, bộ định tuyến đơn giản sẽ sử dụng lớp

composer require pecee/simple-router

Thêm CSRF-Verifier

Khi bạn đã tạo CSRF-Verifer của mình, bạn cần nói với Router đơn giản rằng nó sẽ sử dụng nó. Bạn có thể làm điều này bằng cách thêm dòng sau trong tệp

composer require pecee/simple-router

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Nhận CSRF-Token

Khi đăng lên bất kỳ URL nào có kích hoạt xác minh CSRF, bạn cần đăng CSRF-Token nếu không, yêu cầu sẽ bị từ chối.

Bạn có thể nhận được CSRF-Token bằng cách gọi phương thức trợ giúp:

Bạn cũng có thể nhận được mã thông báo trực tiếp:

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Tên/khóa mặc định cho trường đầu vào là

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

Example:

Ví dụ dưới đây sẽ đăng lên URL hiện tại với trường ẩn "

composer require pecee/simple-router

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

CSRF-Verifier tùy chỉnh

Tạo một lớp mới và mở rộng lớp phần mềm trung gian

composer require pecee/simple-router

Thêm thuộc tính

composer require pecee/simple-router

composer require pecee/simple-router

Dưới đây là một ví dụ cơ bản về lớp CSRF-Verifier:

RewriteEngine on
RewriteCond %{SCRIPT_FILENAME} !-f
RewriteCond %{SCRIPT_FILENAME} !-d
RewriteCond %{SCRIPT_FILENAME} !-l
RewriteRule ^(.*)$ index.php/$1

Nhà cung cấp mã thông báo tùy chỉnh

Theo mặc định,

composer require pecee/simple-router

composer require pecee/simple-router

Nếu bạn cần lưu trữ mã thông báo ở nơi khác, bạn có thể làm điều đó bằng cách tạo lớp của riêng mình và triển khai lớp

composer require pecee/simple-router

RewriteEngine on
RewriteCond %{SCRIPT_FILENAME} !-f
RewriteCond %{SCRIPT_FILENAME} !-d
RewriteCond %{SCRIPT_FILENAME} !-l
RewriteRule ^(.*)$ index.php/$1

Tiếp theo, bạn cần đặt triển khai

composer require pecee/simple-router

composer require pecee/simple-router

RewriteEngine on
RewriteCond %{SCRIPT_FILENAME} !-f
RewriteCond %{SCRIPT_FILENAME} !-d
RewriteCond %{SCRIPT_FILENAME} !-l
RewriteRule ^(.*)$ index.php/$1

Middle Wares

MiddleWares là các lớp tải trước khi tuyến đường được hiển thị. Một phần mềm trung gian có thể được sử dụng để xác minh rằng người dùng được đăng nhập - hoặc để đặt các tham số cụ thể cho yêu cầu/tuyến đường hiện tại. MiddleWares phải triển khai giao diện

composer require pecee/simple-router

Thí dụ

RewriteEngine on
RewriteCond %{SCRIPT_FILENAME} !-f
RewriteCond %{SCRIPT_FILENAME} !-d
RewriteCond %{SCRIPT_FILENAME} !-l
RewriteRule ^(.*)$ index.php/$1

Ngoại lệ

ExceptHandler là các lớp xử lý tất cả các ngoại lệ. Excenshandlers phải triển khai giao diện

composer require pecee/simple-router

Xử lý 404, 403 và các lỗi khác

Nếu bạn chỉ đơn giản muốn bắt một 404 (không tìm thấy trang), v.v., bạn có thể sử dụng phương thức trợ giúp tĩnh

composer require pecee/simple-router

Điều này sẽ thêm một phương thức gọi lại được bắn bất cứ khi nào xảy ra lỗi trên tất cả các tuyến đường.

Ví dụ cơ bản dưới đây chỉ đơn giản là chuyển hướng trang đến

composer require pecee/simple-router

composer require pecee/simple-router

RewriteEngine on
RewriteCond %{SCRIPT_FILENAME} !-f
RewriteCond %{SCRIPT_FILENAME} !-d
RewriteCond %{SCRIPT_FILENAME} !-l
RewriteRule ^(.*)$ index.php/$1

Ví dụ trên sẽ chuyển hướng tất cả các lỗi với mã HTTP

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

Nếu bạn không muốn chuyển hướng, nhưng muốn trang lỗi được hiển thị trên hiện tại-URL, bạn có thể yêu cầu bộ định tuyến thực thi cuộc gọi lại viết lại như vậy:

RewriteEngine on
RewriteCond %{SCRIPT_FILENAME} !-f
RewriteCond %{SCRIPT_FILENAME} !-d
RewriteCond %{SCRIPT_FILENAME} !-l
RewriteRule ^(.*)$ index.php/$1

Sử dụng trình xử lý ngoại lệ tùy chỉnh

Đây là một ví dụ cơ bản về triển khai ExceptHandler (vui lòng xem "Dễ dàng ghi đè tuyến đường sắp được tải" để biết các ví dụ về cách thay đổi cuộc gọi lại).

RewriteEngine on
RewriteCond %{SCRIPT_FILENAME} !-f
RewriteCond %{SCRIPT_FILENAME} !-d
RewriteCond %{SCRIPT_FILENAME} !-l
RewriteRule ^(.*)$ index.php/$1

Bạn có thể thêm lớp Handler ngoại lệ tùy chỉnh của mình vào nhóm của mình bằng cách sử dụng

composer require pecee/simple-router

composer require pecee/simple-router

RewriteEngine on
RewriteCond %{SCRIPT_FILENAME} !-f
RewriteCond %{SCRIPT_FILENAME} !-d
RewriteCond %{SCRIPT_FILENAME} !-l
RewriteRule ^(.*)$ index.php/$1

Ngăn chặn sự hợp nhất của người làm việc ngoại lệ phụ huynh

Theo mặc định, bộ định tuyến sẽ hợp nhất các trình điều khiển ngoại lệ cho bất kỳ trình xử lý nào được cung cấp bởi các nhóm cha mẹ và sẽ được thực thi theo thứ tự mới nhất sang lâu đời nhất.

Nếu bạn muốn trình xử lý ngoại lệ nhóm của mình được thực thi độc lập, bạn có thể thêm thuộc tính

composer require pecee/simple-router

composer require pecee/simple-router

RewriteEngine on
RewriteCond %{SCRIPT_FILENAME} !-f
RewriteCond %{SCRIPT_FILENAME} !-d
RewriteCond %{SCRIPT_FILENAME} !-l
RewriteRule ^(.*)$ index.php/$1

URL

Theo mặc định, tất cả các tuyến điều khiển và tuyến tài nguyên sẽ sử dụng phiên bản đơn giản của URL của họ làm tên.

Bạn dễ dàng sử dụng chức năng trợ giúp phím tắt

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

Nhận URL hiện tại

Nó chưa bao giờ dễ dàng hơn để có được và/hoặc thao tác URL hiện tại.

Ví dụ dưới đây cho bạn biết cách lấy URL hiện tại:

RewriteEngine on
RewriteCond %{SCRIPT_FILENAME} !-f
RewriteCond %{SCRIPT_FILENAME} !-d
RewriteCond %{SCRIPT_FILENAME} !-l
RewriteRule ^(.*)$ index.php/$1

Nhận theo tên (tuyến đường đơn)

xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
	<rewrite>
	  <rules>
		
		<rule name="RewriteRequestsToPublic">
		  <match url="^(.*)$" />
		  <conditions logicalGrouping="MatchAll" trackAllCaptures="false">
		  conditions>
		  <action type="Rewrite" url="/{R:0}" />
		rule>

		
		<rule name="Imported Rule 1" stopProcessing="true">
		  <match url="^(.*)$" ignoreCase="true" />
		  <conditions logicalGrouping="MatchAll">
			<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
			<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
		  conditions>
		  <action type="Rewrite" url="/index.php/{R:1}" appendQueryString="true" />
		rule>
	  rules>
	rewrite>
    system.webServer>
configuration>

Nhận theo tên (tuyến điều khiển)

xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
	<rewrite>
	  <rules>
		
		<rule name="RewriteRequestsToPublic">
		  <match url="^(.*)$" />
		  <conditions logicalGrouping="MatchAll" trackAllCaptures="false">
		  conditions>
		  <action type="Rewrite" url="/{R:0}" />
		rule>

		
		<rule name="Imported Rule 1" stopProcessing="true">
		  <match url="^(.*)$" ignoreCase="true" />
		  <conditions logicalGrouping="MatchAll">
			<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
			<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
		  conditions>
		  <action type="Rewrite" url="/index.php/{R:1}" appendQueryString="true" />
		rule>
	  rules>
	rewrite>
    system.webServer>
configuration>

Nhận theo lớp

xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
	<rewrite>
	  <rules>
		
		<rule name="RewriteRequestsToPublic">
		  <match url="^(.*)$" />
		  <conditions logicalGrouping="MatchAll" trackAllCaptures="false">
		  conditions>
		  <action type="Rewrite" url="/{R:0}" />
		rule>

		
		<rule name="Imported Rule 1" stopProcessing="true">
		  <match url="^(.*)$" ignoreCase="true" />
		  <conditions logicalGrouping="MatchAll">
			<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
			<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
		  conditions>
		  <action type="Rewrite" url="/index.php/{R:1}" appendQueryString="true" />
		rule>
	  rules>
	rewrite>
    system.webServer>
configuration>

Sử dụng tên tùy chỉnh cho các phương thức trên tuyến điều khiển/tài nguyên

xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
	<rewrite>
	  <rules>
		
		<rule name="RewriteRequestsToPublic">
		  <match url="^(.*)$" />
		  <conditions logicalGrouping="MatchAll" trackAllCaptures="false">
		  conditions>
		  <action type="Rewrite" url="/{R:0}" />
		rule>

		
		<rule name="Imported Rule 1" stopProcessing="true">
		  <match url="^(.*)$" ignoreCase="true" />
		  <conditions logicalGrouping="MatchAll">
			<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
			<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
		  conditions>
		  <action type="Rewrite" url="/index.php/{R:1}" appendQueryString="true" />
		rule>
	  rules>
	rewrite>
    system.webServer>
configuration>

Nhận URL Bộ điều khiển REST/Tài nguyên

xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
	<rewrite>
	  <rules>
		
		<rule name="RewriteRequestsToPublic">
		  <match url="^(.*)$" />
		  <conditions logicalGrouping="MatchAll" trackAllCaptures="false">
		  conditions>
		  <action type="Rewrite" url="/{R:0}" />
		rule>

		
		<rule name="Imported Rule 1" stopProcessing="true">
		  <match url="^(.*)$" ignoreCase="true" />
		  <conditions logicalGrouping="MatchAll">
			<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
			<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
		  conditions>
		  <action type="Rewrite" url="/index.php/{R:1}" appendQueryString="true" />
		rule>
	  rules>
	rewrite>
    system.webServer>
configuration>

Thao tác URL

Bạn có thể dễ dàng điều khiển các chuỗi truy vấn, bằng cách thêm các đối số tham số GET của bạn.

xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
	<rewrite>
	  <rules>
		
		<rule name="RewriteRequestsToPublic">
		  <match url="^(.*)$" />
		  <conditions logicalGrouping="MatchAll" trackAllCaptures="false">
		  conditions>
		  <action type="Rewrite" url="/{R:0}" />
		rule>

		
		<rule name="Imported Rule 1" stopProcessing="true">
		  <match url="^(.*)$" ignoreCase="true" />
		  <conditions logicalGrouping="MatchAll">
			<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
			<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
		  conditions>
		  <action type="Rewrite" url="/index.php/{R:1}" appendQueryString="true" />
		rule>
	  rules>
	rewrite>
    system.webServer>
configuration>

Bạn có thể xóa tham số chuỗi truy vấn bằng cách đặt giá trị thành

composer require pecee/simple-router

Ví dụ dưới đây sẽ xóa bất kỳ tham số chuỗi truy vấn nào có tên

composer require pecee/simple-router

xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
	<rewrite>
	  <rules>
		
		<rule name="RewriteRequestsToPublic">
		  <match url="^(.*)$" />
		  <conditions logicalGrouping="MatchAll" trackAllCaptures="false">
		  conditions>
		  <action type="Rewrite" url="/{R:0}" />
		rule>

		
		<rule name="Imported Rule 1" stopProcessing="true">
		  <match url="^(.*)$" ignoreCase="true" />
		  <conditions logicalGrouping="MatchAll">
			<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
			<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
		  conditions>
		  <action type="Rewrite" url="/index.php/{R:1}" appendQueryString="true" />
		rule>
	  rules>
	rewrite>
    system.webServer>
configuration>

Để biết thêm thông tin, vui lòng kiểm tra phần Thủ thuật URL hữu ích của tài liệu.

Thủ thuật URL hữu ích

Gọi

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

Tuy nhiên, điều này cho phép chúng tôi sử dụng các phương thức hữu ích trên đối tượng

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

Trong ví dụ dưới đây, chúng tôi kiểm tra xem URL hiện tại có chứa phần

composer require pecee/simple-router

xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
	<rewrite>
	  <rules>
		
		<rule name="RewriteRequestsToPublic">
		  <match url="^(.*)$" />
		  <conditions logicalGrouping="MatchAll" trackAllCaptures="false">
		  conditions>
		  <action type="Rewrite" url="/{R:0}" />
		rule>

		
		<rule name="Imported Rule 1" stopProcessing="true">
		  <match url="^(.*)$" ignoreCase="true" />
		  <conditions logicalGrouping="MatchAll">
			<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
			<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
		  conditions>
		  <action type="Rewrite" url="/index.php/{R:1}" appendQueryString="true" />
		rule>
	  rules>
	rewrite>
    system.webServer>
configuration>

Như đã đề cập trước đó, bạn cũng có thể sử dụng đối tượng

composer require pecee/simple-router

xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
	<rewrite>
	  <rules>
		
		<rule name="RewriteRequestsToPublic">
		  <match url="^(.*)$" />
		  <conditions logicalGrouping="MatchAll" trackAllCaptures="false">
		  conditions>
		  <action type="Rewrite" url="/{R:0}" />
		rule>

		
		<rule name="Imported Rule 1" stopProcessing="true">
		  <match url="^(.*)$" ignoreCase="true" />
		  <conditions logicalGrouping="MatchAll">
			<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
			<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
		  conditions>
		  <action type="Rewrite" url="/index.php/{R:1}" appendQueryString="true" />
		rule>
	  rules>
	rewrite>
    system.webServer>
configuration>

Để biết thêm các phương pháp có sẵn, vui lòng kiểm tra lớp

composer require pecee/simple-router

Đầu vào & tham số

Bộ định tuyến đơn giản cung cấp các thư viện và người trợ giúp giúp bạn dễ dàng quản lý và thao tác các tham số đầu vào như

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

Sử dụng lớp đầu vào để quản lý các tham số

Bạn có thể sử dụng lớp

composer require pecee/simple-router

composer require pecee/simple-router

Nhận giá trị tham số đơn

composer require pecee/simple-router

Để nhanh chóng nhận được giá trị từ một tham số, bạn có thể sử dụng hàm trợ giúp

composer require pecee/simple-router

Điều này sẽ tự động cắt giá trị và đảm bảo rằng nó không trống. Nếu nó trống,

composer require pecee/simple-router

Lưu ý: Hàm này trả về

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

Example:

Ví dụ này phù hợp với cả bài đăng và nhận phương pháp yêu cầu và nếu tên trống thì "khách" có giá trị mặc định sẽ được trả về.

xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
	<rewrite>
	  <rules>
		
		<rule name="RewriteRequestsToPublic">
		  <match url="^(.*)$" />
		  <conditions logicalGrouping="MatchAll" trackAllCaptures="false">
		  conditions>
		  <action type="Rewrite" url="/{R:0}" />
		rule>

		
		<rule name="Imported Rule 1" stopProcessing="true">
		  <match url="^(.*)$" ignoreCase="true" />
		  <conditions logicalGrouping="MatchAll">
			<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
			<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
		  conditions>
		  <action type="Rewrite" url="/index.php/{R:1}" appendQueryString="true" />
		rule>
	  rules>
	rewrite>
    system.webServer>
configuration>

Nhận đối tượng tham số

Khi xử lý các tệp tải tệp, nó có thể hữu ích để truy xuất đối tượng tham số thô.

Tìm kiếm đối tượng với giá trị mặc định trên nhiều phương pháp yêu cầu cụ thể hoặc cụ thể:

Ví dụ dưới đây sẽ trả về một đối tượng

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

Nhận tham số

composer require pecee/simple-router

composer require pecee/simple-router

Ví dụ dưới đây sẽ trả về một đối tượng

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

Nhận tham số

composer require pecee/simple-router

composer require pecee/simple-router

Ví dụ dưới đây sẽ trả về một đối tượng

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

Nhận tham số

composer require pecee/simple-router

composer require pecee/simple-router

Ví dụ dưới đây sẽ trả về một đối tượng

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

Quản lý tập tin

Nhận tất cả các tham số

Tất cả các đối tượng thực hiện giao diện

composer require pecee/simple-router

• composer require pecee/simple-router

  56 - Trả về chỉ mục/khóa của đầu vào.

• composer require pecee/simple-router

  57 - Đặt chỉ mục/khóa của đầu vào.

• composer require pecee/simple-router

  58 - Trả về một tên thân thiện với con người cho đầu vào (công ty_name sẽ là tên công ty, v.v.).

• composer require pecee/simple-router

  59 - Đặt tên thân thiện với con người cho đầu vào (công ty_name sẽ là tên công ty, v.v.).

• composer require pecee/simple-router

  60 - Trả về giá trị của đầu vào.

• composer require pecee/simple-router

  61 - Đặt giá trị của đầu vào.

composer require pecee/simple-router

• composer require pecee/simple-router

  63 - Nhận tên tệp.

• composer require pecee/simple-router

  64 - Nhận tệp tạm thời.

• composer require pecee/simple-router

  65 - Nhận kích thước tệp.

• composer require pecee/simple-router

  66 - Di chuyển tệp đến đích.

• composer require pecee/simple-router

  67 - Nhận nội dung tệp.

• composer require pecee/simple-router

  68 - Nhận loại MIME cho tệp.

• composer require pecee/simple-router

  69 - Nhận lỗi tải lên tệp.

• composer require pecee/simple-router

  70 - Trả về

  composer require pecee/simple-router

  71 nếu xảy ra lỗi trong khi tải lên (nếu

  composer require pecee/simple-router

  72 không phải là 0).

• composer require pecee/simple-router

  73 - Trả về mảng thô

Kiểm tra xem các tham số có tồn tại không

Bạn có thể dễ dàng nếu nhiều mục tồn tại bằng cách sử dụng phương thức

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

Example:

Sự kiện

Phần này sẽ giúp bạn hiểu cách đăng ký các cuộc gọi lại của riêng bạn vào các sự kiện trong bộ định tuyến. Nó cũng sẽ bao gồm những điều cơ bản của người làm việc sự kiện; Cách sử dụng các trình xử lý được cung cấp với bộ định tuyến và cách tạo các công cụ sự kiện tùy chỉnh của riêng bạn.

Các sự kiện có sẵn

Phần này chứa tất cả các sự kiện có sẵn có thể được đăng ký bằng cách sử dụng

composer require pecee/simple-router

Tất cả các cuộc gọi lại sự kiện sẽ truy xuất một đối tượng

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

composer require pecee/simple-router

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

composer require pecee/simple-router

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

composer require pecee/simple-router

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

composer require pecee/simple-router

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

composer require pecee/simple-router

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

composer require pecee/simple-router

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

composer require pecee/simple-router

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Các đám cháy trước khi dây giữa cho một tuyến đường được thực hiện.

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Example:

Các vụ cháy trước khi CSRF-Verifier được thực hiện.

Đăng ký sự kiện mới

Để đăng ký một sự kiện mới, bạn cần tạo một thể hiện mới của đối tượng

composer require pecee/simple-router

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Khi bạn đã đăng ký các sự kiện, hãy đảm bảo thêm nó vào bộ định tuyến bằng cách gọi

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

composer require pecee/simple-router

Chúng ta hãy đi qua cách tạo lớp Handler sự kiện rất riêng của bạn.

Dưới đây là một ví dụ cơ bản về một người điều khiển sự kiện tùy chỉnh có tên là

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Nâng cao

Tắt nhiều tuyến đường

Theo mặc định, bộ định tuyến sẽ cố gắng thực hiện tất cả các tuyến khớp khớp với một URL đã cho. Để dừng bộ định tuyến thực hiện bất kỳ tuyến đường nào nữa, bất kỳ phương thức nào cũng có thể trả về một giá trị.

Hành vi này có thể được vô hiệu hóa bằng cách đặt

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

composer require pecee/simple-router

Hạn chế quyền truy cập vào IP

Bạn có thể truy cập danh sách trắng và/hoặc danh sách đen vào IP bằng cách sử dụng bản dựng trong phần mềm trung gian

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Tạo phần mềm trung gian tùy chỉnh của riêng bạn và mở rộng lớp

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Lớp

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Bạn có thể sử dụng

composer require pecee/simple-router

Bạn có thể thêm phần mềm trung gian vào nhiều tuyến đường bằng cách thêm phần mềm trung gian của bạn vào một nhóm.

Đặt đường dẫn cơ sở tùy chỉnh

Đôi khi nó có thể hữu ích để thêm một đường dẫn cơ sở tùy chỉnh vào tất cả các tuyến đường được thêm vào.

Điều này có thể dễ dàng được thực hiện bằng cách tận dụng hỗ trợ xử lý sự kiện của dự án.

Trong ví dụ được hiển thị ở trên, chúng tôi tạo ra một sự kiện

composer require pecee/simple-router

Viết lại URL

Thay đổi tuyến đường hiện tại

Đôi khi nó có thể hữu ích để điều khiển tuyến đường sắp được tải. Bộ định tuyến đơn giản cho phép bạn dễ dàng thao tác và thay đổi các tuyến sắp được hiển thị. Tất cả thông tin về tuyến đường hiện tại được lưu trữ trong thuộc tính

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Để dễ dàng truy cập, bạn có thể sử dụng chức năng trợ giúp phím tắt

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

BootManager: Đang tải các tuyến đường động

Đôi khi có thể cần phải giữ các URL được lưu trữ trong cơ sở dữ liệu, tệp hoặc tương tự. Trong ví dụ này, chúng tôi muốn URL

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

composer require pecee/simple-router

Để can thiệp vào bộ định tuyến, chúng tôi tạo một lớp thực hiện giao diện

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

composer require pecee/simple-router

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Các điều trên phải khá tự giải thích và có thể dễ dàng thay đổi thành vòng lặp qua lưu trữ URL trong cơ sở dữ liệu, tệp hoặc bộ đệm.

Điều xảy ra là nếu tuyến đường hiện tại khớp với tuyến đường được xác định trong chỉ mục của mảng

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Bằng cách này, tuyến đường bây giờ sẽ tải URL

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Điều cuối cùng chúng ta cần làm, là thêm trình quản lý khởi động tùy chỉnh của chúng tôi vào tệp

composer require pecee/simple-router

composer require pecee/simple-router

Thêm các tuyến đường bằng tay

Lớp

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Trình tải lớp tùy chỉnh

Bạn có thể dễ dàng mở rộng bộ định tuyến đơn giản để hỗ trợ các khung tiêm tùy chỉnh như PHP-di bằng cách tận dụng khả năng thêm trình tải lớp tùy chỉnh của bạn.

Trình tải lớp phải kế thừa giao diện

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Example:

Tiếp theo, chúng tôi cần định cấu hình

composer require pecee/simple-router

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

composer require pecee/simple-router

Tích hợp với PHP-di

Hỗ trợ PHP-DI đã bị ngừng bởi phiên bản 4.3, tuy nhiên bạn có thể dễ dàng thêm nó một lần nữa bằng cách tạo trình tải lớp của riêng bạn như ví dụ dưới đây:

Thông số

Phần này chứa các mẹo & thủ thuật nâng cao về việc mở rộng việc sử dụng cho các tham số.

Mở rộng

Đây là một ví dụ đơn giản về tích hợp vào một khung.

Khung có lớp

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

composer require pecee/simple-router

Giúp đỡ và hỗ trợ

Phần này sẽ đi vào chi tiết về cách gỡ lỗi bộ định tuyến và trả lời một số câu hỏi thường gặp- và các vấn đề.

Các vấn đề và sửa chữa phổ biến

Phần này sẽ đi qua các vấn đề phổ biến và cách giải quyết chúng.

Tham số sẽ không khớp hoặc tuyến không hoạt động với các ký tự đặc biệt

Mọi người thường gặp vấn đề này khi một hoặc nhiều tham số chứa các ký tự đặc biệt. Bộ định tuyến sử dụng biểu thức thường xuyên thưa thớt phù hợp với các chữ cái từ A-Z cùng với các số khi khớp các tham số, để cải thiện hiệu suất.

Tất cả các ký tự khác phải được xác định thông qua tùy chọn

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Bạn có thể đọc thêm về việc thêm biểu thức thông thường tùy chỉnh của riêng bạn để phù hợp với các tham số bằng cách nhấp vào đây.

Nhiều tuyến đường phù hợp? Cái nào có ưu tiên?

Bộ định tuyến sẽ khớp các tuyến theo thứ tự chúng được thêm vào và sẽ hiển thị nhiều tuyến đường, nếu chúng khớp.

Nếu bạn muốn bộ định tuyến dừng khi một tuyến đường được khớp, bạn chỉ cần trả về giá trị trong cuộc gọi lại của mình hoặc dừng thực thi theo cách thủ công (sử dụng

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Bất kỳ đối tượng được trả về nào thực hiện phương pháp ma thuật

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Nếu bạn muốn bộ định tuyến chỉ thực hiện một tuyến đường cho mỗi yêu cầu, bạn có thể vô hiệu hóa nhiều kết xuất tuyến đường.

Sử dụng bộ định tuyến trên các con đường phụ

Vui lòng tham khảo thiết lập một phần đường dẫn cơ sở tùy chỉnh của tài liệu.

Gỡ lỗi

Phần này sẽ chỉ cho bạn cách viết các bài kiểm tra đơn vị cho bộ định tuyến, xem thông tin gỡ lỗi hữu ích và trả lời một số câu hỏi thường gặp.

Nó cũng sẽ bao gồm cách báo cáo bất kỳ vấn đề nào bạn có thể gặp phải.

Tạo các bài kiểm tra đơn vị

Cách dễ nhất và nhanh nhất để gỡ lỗi bất kỳ vấn đề nào với bộ định tuyến, là tạo ra một bài kiểm tra đơn vị đại diện cho vấn đề bạn đang gặp phải.

Các thử nghiệm đơn vị sử dụng một lớp

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Lớp

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Sử dụng người trợ giúp testrouter

Tùy thuộc vào bài kiểm tra của bạn, bạn có thể sử dụng các phương thức dưới đây khi kết xuất các tuyến đường trong các bài kiểm tra đơn vị của bạn.

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Thông tin gỡ lỗi

Thư viện có thể xuất thông tin gỡ lỗi, chứa thông tin như các tuyến đường tải, yêu cầu phân tích cú pháp, v.v. .

Bạn có thể kích hoạt thông tin gỡ lỗi bằng cách gọi phương pháp bắt đầu thay thế.

Ví dụ dưới đây sẽ bắt đầu định tuyến một mảng trả lại với thông tin gỡ lỗi

Example:

/index.php/test/mypage.php

Ví dụ trên sẽ cung cấp cho bạn một đầu ra chứa:

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

composer require pecee/simple-router

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

/index.php/test/mypage.php

/index.php/test/mypage.php

/index.php/test/mypage.php

/index.php/test/mypage.php

use Pecee\SimpleRouter\SimpleRouter;

/* Load external routes file */
require_once 'routes.php';

/**
 * The default namespace for route-callbacks, so we don't have to specify it each time.
 * Can be overwritten by using the namespace config option on your routes.
 */

SimpleRouter::setDefaultNamespace('\Demo\Controllers');

// Start the routing
SimpleRouter::start();

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

composer require pecee/simple-router

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

90

Lớp CSRFverifier

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Example:

/index.php/test/mypage.php

Danh sách các tin nhắn gỡ lỗi/nhật ký từ bộ định tuyến.

Example:

/index.php/test/mypage.php

location / { try_files $uri $uri/ /index.php?$query_string; } 92

Đầu ra gọi lại từ bộ định tuyến.

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Phiên bản của bộ định tuyến đơn giản mà bạn đang sử dụng.

1. location / {
       try_files $uri $uri/ /index.php?$query_string;
   }
   

   94
2. Thêm một tiêu đề mô tả các vấn đề của bạn trong càng ít từ càng tốt.
3. Sao chép và dán mẫu bên dưới trong mô tả về vấn đề của bạn và thay thế từng bước bằng thông tin của riêng bạn. Nếu bước không liên quan đến vấn đề của bạn, bạn có thể xóa nó.

Mẫu phát hành

Sao chép và dán mẫu bên dưới vào mô tả về vấn đề mới của bạn và thay thế nó bằng thông tin của riêng bạn.

Bạn có thể kiểm tra phần Thông tin gỡ lỗi để xem cách tạo bản gỡ lỗi.

/index.php/test/mypage.php

Hãy nhớ rằng một vấn đề chi tiết hơn- mô tả và gỡ lỗi-INFO có thể hút để viết, nhưng nó sẽ giúp người khác hiểu- và giải quyết vấn đề của bạn mà không cần thông tin.

Lưu ý: Vui lòng càng chi tiết trong mô tả khi tạo ra một vấn đề mới. Điều này sẽ giúp người khác dễ hiểu hơn- và giải quyết vấn đề của bạn. Cung cấp các bước cần thiết để tái tạo lỗi trong mô tả của bạn, thêm thông tin gỡ lỗi hữu ích, vv sẽ giúp người khác nhanh chóng giải quyết vấn đề bạn đang báo cáo. please be as detailed as possible in the description when creating a new issue. This will help others to more easily understand- and solve your issue. Providing the necessary steps to reproduce the error within your description, adding useful debugging info etc. will help others quickly resolve the issue you are reporting.

Phản hồi và phát triển

Nếu thư viện thiếu một tính năng mà bạn cần trong dự án của mình hoặc nếu bạn có phản hồi, chúng tôi rất muốn nghe từ bạn. Hãy để lại cho chúng tôi phản hồi bằng cách tạo ra một vấn đề mới.

Trải qua một vấn đề?

Vui lòng tham khảo phần trợ giúp và hỗ trợ của chúng tôi trong tài liệu trước khi báo cáo một vấn đề mới.

Hướng dẫn phát triển đóng góp

• Vui lòng cố gắng làm theo hướng dẫn Codestyle PSR-2.

• Vui lòng tạo các yêu cầu kéo của bạn đến cơ sở phát triển phù hợp với số phiên bản bạn muốn thay đổi. Ví dụ: khi đẩy các thay đổi sang phiên bản 3, yêu cầu kéo nên sử dụng cơ sở/nhánh

  RewriteEngine on
  RewriteCond %{SCRIPT_FILENAME} !-f
  RewriteCond %{SCRIPT_FILENAME} !-d
  RewriteCond %{SCRIPT_FILENAME} !-l
  RewriteRule ^(.*)$ index.php/$1
  

  02.

• Tạo các mô tả chi tiết cho các cam kết của bạn, vì chúng sẽ được sử dụng trong Changelog cho các bản phát hành mới.

• Khi thay đổi chức năng hiện có, vui lòng đảm bảo rằng các bài kiểm tra đơn vị hoạt động.

• Khi thêm công cụ mới, vui lòng nhớ thêm các bài kiểm tra đơn vị mới cho chức năng.

Tín dụng

Trang web

Đây là một số trang web sử dụng dự án bộ định tuyến đơn giản trong sản xuất.

• holla.dk
• ninjaimg.com
• bookandbegin.com
• dscuz.com

Giấy phép

Giấy phép MIT (MIT)

Bản quyền (c) 2016 Simon Sessingø / Simple-php-Router

Quyền được cấp, miễn phí, cho bất kỳ ai có được bản sao phần mềm này và các tệp tài liệu liên quan ("phần mềm"), để giải quyết phần mềm mà không bị hạn chế, bao gồm không giới hạn quyền sử dụng, sao chép, sửa đổi, hợp nhất , Xuất bản, Phân phối, Bán cấp và/hoặc Bán các bản sao của phần mềm và cho phép những người mà phần mềm được cung cấp để làm như vậy, tuân theo các điều kiện sau:

Thông báo bản quyền trên và Thông báo quyền này sẽ được bao gồm trong tất cả các bản sao hoặc các phần đáng kể của phần mềm.

Phần mềm được cung cấp "như là", không có bảo hành dưới bất kỳ hình thức nào, rõ ràng hay ngụ ý, bao gồm nhưng không giới hạn trong các bảo đảm của thương mại, thể lực cho một mục đích cụ thể và không bị thiếu sót. Trong mọi trường hợp, các tác giả hoặc chủ bản quyền sẽ phải chịu trách nhiệm đối với bất kỳ khiếu nại, thiệt hại hoặc trách nhiệm nào khác, cho dù trong hành động của hợp đồng, tra tấn hay nói cách khác, phát sinh từ hoặc liên quan đến phần mềm hoặc việc sử dụng hoặc các giao dịch khác trong PHẦN MỀM.