[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_WARNING
s, 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 include
0 trên Windows hoặc include
1 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 include
2 hoặc include
3] - 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 include
4, 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
include
6
include
7
include
8Nế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
include
9
include
0
include
1Khi 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
include
3
include
4
include
5Cả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ề include
7 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ề include
8. 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_WARNING
0
Ví dụ #5 include
và câu lệnh trả vềreturn statement
E_WARNING
2
E_WARNING
3
E_WARNING
4E_WARNING
5 là giá trị include
8 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_WARNING
7 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_WARNING
7 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_ERROR
0
E_ERROR
1
E_ERROR
2Để 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_ERROR
3
Phát ban ¶ ¶
7 năm trước
E_ERROR
4
E_ERROR
5
E_ERROR
6
E_ERROR
7John Carty ¶ ¶
6 năm trước
E_ERROR
8
E_ERROR
9
include
0
include
1
include
2
include
3
include
4
include
5
include
6Anon ¶ ¶
10 năm trước
include
7
Lỗi17191 tại Gmail Dot Com ¶ ¶
7 năm trước
include
8
include
9
require
0
require
1
include
6John Carty ¶ ¶
6 năm trước
require
3
require
4
include
6
Anon ¶ ¶
6 năm trước
require
6
require
7
require
8
require
9
E_WARNING
0
E_WARNING
1
E_WARNING
2
include
6Anon ¶ ¶
10 năm trước
E_WARNING
4
E_WARNING
5
include
6Lỗi17191 tại Gmail Dot Com ¶ ¶
WADE. ¶
E_WARNING
7
E_WARNING
8
include
614 năm trước ¶
Rick Garcia ¶
E_WARNING
0
jbezorg tại gmail dot com ¶ ¶
4 năm trước
E_WARNING
1
E_WARNING
2
include
6Ray.paseur thường sử dụng gmail ¶ ¶
8 năm trước
E_WARNING
4
E_WARNING
5
E_WARNING
6
E_WARNING
7
E_WARNING
8
include
6Anonphpuser ¶ ¶
8 năm trước
E_ERROR
0
E_ERROR
1
E_ERROR
2
include
6Anonphpuser ¶ ¶
8 năm trước
E_ERROR
4
E_ERROR
5
E_ERROR
6
E_ERROR
7
E_ERROR
8
E_ERROR
9
include
00Anonphpuser ¶ ¶
2 ngày trước
include
01
splayer ¶ ¶
11 năm trước
include
02
include
03
include
6Joe Dot Naylor tại Gmail Dot Com ¶ ¶
6 năm trước
include
05
include
06
include
07
include
08
include
09Anon ¶ ¶
10 năm trước
include
10
include
11
include
12
include
13
include
14
include
15
include
6Lỗi17191 tại Gmail Dot Com ¶ ¶
WADE. ¶
include
17
include
18
include
19
include
20
include
21
include
22
include
614 năm trước ¶
10 năm trước
include
24
include
25
include
26
include
27Lỗi17191 tại Gmail Dot Com ¶ ¶
6 năm trước
include
28
include
29
include
6Anon ¶ ¶
7 năm trước
include
31
include
32
include
33