(Php 4, Php 5, Php 7, Php 8)
Biểu thức include bao gồm và đánh giá tệp được chỉ định.
Các tài liệu dưới đây cũng áp dụng để yêu cầu.require.
Các tệp được bao gồm dựa trên đường dẫn tệp được cung cấp hoặc, nếu không được cung cấp, bao gồm_path được chỉ định. Nếu tệp không được tìm thấy trong bao gồm_path, include cuối cùng sẽ kiểm tra thư mục riêng của tập lệnh gọi và thư mục làm việc hiện tại trước khi không thành công. Cấu trúc include sẽ phát ra một E_WARNING nếu nó không thể tìm thấy một tệp; Đây là hành vi khác với yêu cầu, sẽ phát ra một E_ERROR.E_WARNING if it cannot find a file; this is different behavior from require, which will emit an E_ERROR.
Lưu ý rằng cả include và require đều tăng thêm E_WARNING, nếu không thể truy cập tệp, trước khi tăng lần lượt là E_WARNING hoặc E_ERROR cuối cùng.E_WARNINGs, if the file cannot be accessed, before raising the final E_WARNING or E_ERROR, respectively.
Nếu một đường dẫn được xác định - cho dù là tuyệt đối (bắt đầu bằng ký tự ổ đĩa hoặc include0 trên Windows hoặc include1 trên các hệ thống Unix/Linux) hoặc liên quan đến thư mục hiện tại (bắt đầu bằng include2 hoặc include3) - bao gồm_path sẽ bị bỏ qua hoàn toàn. Ví dụ: nếu một tên tệp bắt đầu bằng include4, trình phân tích cú pháp sẽ tìm trong thư mục cha để tìm tệp được yêu cầu.
Để biết thêm thông tin về cách xử lý PHP bao gồm các tệp và đường dẫn bao gồm, hãy xem tài liệu cho bao gồm_path.
Khi một tệp được bao gồm, mã nó chứa kế thừa phạm vi biến của dòng mà bao gồm xảy ra. Bất kỳ biến nào có sẵn ở dòng đó trong tệp gọi sẽ có sẵn trong tệp được gọi, từ thời điểm đó trở đi. Tuy nhiên, tất cả các chức năng và các lớp được xác định trong tệp bao gồm có phạm vi toàn cầu.
Ví dụ #1 Ví dụ include cơ bản
include6
include7
include8Nếu bao gồm xảy ra bên trong một hàm trong tệp gọi, thì tất cả các mã có trong tệp được gọi sẽ hoạt động như thể nó đã được xác định bên trong hàm đó. Vì vậy, nó sẽ theo phạm vi biến của chức năng đó. Một ngoại lệ cho quy tắc này là các hằng số ma thuật được đánh giá bởi trình phân tích cú pháp trước khi bao gồm xảy ra.
Ví dụ #2 bao gồm trong các chức năng
include9
include0
include1Khi bao gồm một tệp, phân tích cú pháp rơi ra khỏi chế độ PHP và vào chế độ HTML ở đầu tệp đích và tiếp tục lại ở cuối. Vì lý do này, bất kỳ mã nào bên trong tệp đích sẽ được thực thi dưới dạng mã PHP phải được đặt trong các thẻ bắt đầu và kết thúc PHP hợp lệ.
Nếu "URL bao gồm trình bao bọc" được bật trong PHP, bạn có thể chỉ định tệp được bao gồm bằng URL (thông qua HTTP hoặc trình bao bọc được hỗ trợ khác - xem các giao thức và trình bao quy hoạt được hỗ trợ cho danh sách các giao thức) thay vì tên đường dẫn cục bộ. Nếu máy chủ đích diễn giải tệp đích làm mã PHP, các biến có thể được chuyển đến tệp được bao gồm bằng chuỗi yêu cầu URL như được sử dụng với HTTP GET. Điều này không hoàn toàn nói điều tương tự như bao gồm tệp và việc kế thừa phạm vi biến của tệp cha mẹ; Kịch bản thực sự đang được chạy trên máy chủ từ xa và kết quả sau đó được đưa vào tập lệnh cục bộ.
Ví dụ #3 include đến HTTP
include3
include4
include5Cảnh báo
Cảnh báo an ninh
Tệp từ xa có thể được xử lý tại máy chủ từ xa (tùy thuộc vào phần mở rộng tệp và thực tế nếu máy chủ từ xa chạy PHP hay không) nhưng nó vẫn phải tạo ra một tập lệnh PHP hợp lệ vì nó sẽ được xử lý tại máy chủ cục bộ. Nếu tệp từ máy chủ từ xa nên được xử lý ở đó và chỉ xuất ra, readFile () có chức năng tốt hơn nhiều để sử dụng. Nếu không, cần phải chăm sóc đặc biệt để bảo mật tập lệnh từ xa để tạo mã hợp lệ và mong muốn.readfile() is much better function to use. Otherwise, special care should be taken to secure the remote script to produce a valid and desired code.
Xem thêm các tệp từ xa, fopen () và file () để biết thông tin liên quan.fopen() and file() for related information.
Trả lại xử lý: include Trả về include7 về thất bại và đưa ra cảnh báo. Thành công bao gồm, trừ khi được ghi đè bởi tệp đi kèm, trả về include8. Có thể thực thi câu lệnh trả về bên trong một tệp được bao gồm để chấm dứt xử lý trong tệp đó và quay lại tập lệnh gọi nó. Ngoài ra, có thể trả về các giá trị từ các tệp được bao gồm. Bạn có thể lấy giá trị của cuộc gọi bao gồm như bạn sẽ làm cho một hàm bình thường. Tuy nhiên, điều này không thể xảy ra khi bao gồm các tệp từ xa trừ khi đầu ra của tệp từ xa có thẻ bắt đầu và kết thúc PHP hợp lệ (như với bất kỳ tệp cục bộ nào). Bạn có thể khai báo các biến cần thiết trong các thẻ đó và chúng sẽ được giới thiệu tại bất kỳ điểm nào được đưa vào tệp.return statement inside an included file in order to terminate processing in that file and return to the script which called it. Also, it's possible to return values from included files. You can take the value of the include call as you would for a normal function. This is not, however, possible when including remote files unless the output of the remote file has valid PHP start and end tags (as with any local file). You can declare the needed variables within those tags and they will be introduced at whichever point the file was included.
Bởi vì include là một cấu trúc ngôn ngữ đặc biệt, dấu ngoặc đơn không cần thiết xung quanh lập luận của nó. Hãy cẩn thận khi so sánh giá trị trả lại.
Ví dụ #4 So sánh giá trị trả về của bao gồm
E_WARNING0
Ví dụ #5 include và câu lệnh trả vềreturn statement
E_WARNING2
E_WARNING3
E_WARNING4E_WARNING5 là giá trị include8 vì bao gồm đã thành công. Lưu ý sự khác biệt giữa các ví dụ trên. Việc sử dụng đầu tiên trả về trong tệp được bao gồm trong khi tài liệu khác thì không. Nếu tệp không thể được bao gồm, E_WARNING7 sẽ được trả về và E_WARNING được phát hành.return within the included file while the other does not. If the file can't be included, E_WARNING7 is returned and E_WARNING is issued.
Nếu có các chức năng được xác định trong tệp bao gồm, chúng có thể được sử dụng trong tệp chính độc lập nếu chúng trước khi trả về hoặc sau. Nếu tệp được bao gồm hai lần, PHP sẽ gây ra lỗi nghiêm trọng vì các chức năng đã được khai báo. Nên sử dụng bao gồm_once thay vì kiểm tra xem tệp đã được bao gồm và có điều kiện trả về bên trong tệp được bao gồm.return or after. If the file is included twice, PHP will raise a fatal error because the functions were already declared. It is recommended to use include_once instead of checking if the file was already included and conditionally return inside the included file.
Một cách khác để "bao gồm" một tệp PHP vào một biến là nắm bắt đầu ra bằng cách sử dụng các chức năng điều khiển đầu ra với include. Ví dụ:
Ví dụ #6 Sử dụng bộ đệm đầu ra để bao gồm tệp PHP vào chuỗi
E_ERROR0
E_ERROR1
E_ERROR2Để tự động bao gồm các tệp trong các tập lệnh, hãy xem thêm các tùy chọn cấu hình auto_prepend_file và auto_append_file trong php.ini.
Lưu ý: Bởi vì đây là một cấu trúc ngôn ngữ và không phải là một hàm, nó không thể được gọi là sử dụng các hàm biến hoặc các đối số được đặt tên.: Because this is a language construct and not a function, it cannot be called using variable functions, or named arguments.
Xem thêm Yêu cầu, Yêu cầu_once, Bao gồm_once, get_included_files (), readFile (), ảo () và bao gồm_path.require, require_once, include_once, get_included_files(), readfile(), virtual(), and include_path.
Snowyurik tại gmail dot com ¶
13 năm trước
E_ERROR3
Phát ban ¶ ¶
7 năm trước
E_ERROR4
E_ERROR5
E_ERROR6
E_ERROR7John Carty ¶ ¶
6 năm trước
E_ERROR8
E_ERROR9
include0
include1
include2
include3
include4
include5
include6Anon ¶ ¶
10 năm trước
include7
Lỗi17191 tại Gmail Dot Com ¶ ¶
7 năm trước
include8
include9
require0
require1
include6John Carty ¶ ¶
13 năm trước
require3
require4
include6Phát ban ¶ ¶
7 năm trước
require6
require7
require8
require9
E_WARNING0
E_WARNING1
E_WARNING2
include6John Carty ¶ ¶
6 năm trước
E_WARNING4
E_WARNING5
include6Anon ¶ ¶
10 năm trước
E_WARNING7
E_WARNING8
include6Lỗi17191 tại Gmail Dot Com ¶ ¶
WADE. ¶
E_WARNING0
E_WARNING1
include6Rick Garcia ¶ ¶
14 năm trước
E_WARNING3
E_WARNING4
E_WARNING5
E_WARNING6
E_WARNING7
E_WARNING8
E_WARNING9jbezorg tại gmail dot com ¶ ¶
WADE. ¶
E_ERROR0
E_ERROR1
E_ERROR2
E_ERROR3
E_ERROR4
include6Rick Garcia ¶ ¶
14 năm trước
E_ERROR6
jbezorg tại gmail dot com ¶ ¶
14 năm trước
E_ERROR7
E_ERROR8
E_ERROR9
include6jbezorg tại gmail dot com ¶ ¶
4 năm trước
include01
include02
include6Ray.paseur thường sử dụng gmail ¶ ¶
7 năm trước
include04
include05
include06
include07
include08John Carty ¶ ¶
6 năm trước
include09
include10
include11
include12
include13
include14
include6Anon ¶ ¶
10 năm trước
include16
include17
include18
include19
include20
include21
include6Lỗi17191 tại Gmail Dot Com ¶ ¶
6 năm trước
include23
include24
include25
include26Anon ¶ ¶
7 năm trước
include27
include28
include6John Carty ¶ ¶
7 năm trước
include30
include31
include32
include33