{"id":1069,"date":"2016-03-09T07:59:42","date_gmt":"2016-03-09T07:59:42","guid":{"rendered":"http:\/\/www.jquery-az.com\/?p=1069"},"modified":"2023-09-23T12:25:11","modified_gmt":"2023-09-23T12:25:11","slug":"php-include-vs-require-explained-with-different-examples","status":"publish","type":"post","link":"https:\/\/www.jquery-az.com\/php-include-vs-require-explained-with-different-examples\/","title":{"rendered":"PHP include VS require: explained with different examples"},"content":{"rendered":"

The purpose of include and require statements in PHP<\/strong><\/h3>\n

The include and require PHP statements are used to include the specified files in the calling file\/program.<\/p>\n

For example:<\/strong><\/p>\n

include(\"user_auth.php\");\r\n\r\n\u00a0\r\n\r\nrequire(\"scripts\/db_connect.php\");<\/pre>\n
The code of the specified file will be copied to the calling program before execution by using the include or require statements.<\/p>\n
This feature is particularly useful if you have to use the same code of PHP, HTML, etc. in multiple pages. For example, you have to establish a connection with MySQL or some other database from 100s of pages. You have to use the same piece of code to connect to a database server.<\/p>\n
Instead, you may create a file e.g. db_connection.php<\/em>, and write the code of the DB connection in it. Juts use the include or require statements in those 100s of pages and include that db_connection.php<\/em> file. Not only it will simplify the code if in the future DB parameters are changed like user_id, password,<\/em> etc. You have to change this only in the db_connection.php<\/em> file.<\/p>\n
Similarly, you may use one file for the left, header, and footer bars\/menus or widgets across the website by using include or require statements.<\/p>\n
The only difference between include and require statements is described below.<\/em><\/p>\n
In case of include statement:<\/strong><\/p>\n
If the specified file is not found, the program will generate a warning message. In that case, the execution of the rest of the program will continue and users will see only a warning message (if settings are made in the configuration file). This may be useful in case the included file does not impact the other program sections.<\/p>\n
In case of require statement:<\/strong><\/p>\n
If a given file is not found after using the PHP require statement, the program will generate a fatal error (E_COMPILE_ERROR<\/strong>). It will halt the script. So, the require statement may be used in scenarios where other sections of the program are dependent on the included file. For example, it contains DB script that connects to the database and fetches the rows from a MySQL table. This data is displayed in an HTML table.<\/p>\n
The following section demonstrates the ways to include files by using PHP include and require<\/strong> statements.<\/p>\n
An example of using PHP include statement<\/strong><\/h3>\n
In this example, two PHP files are created. The first file, define_variables.php<\/em> contains two variables. The other file calls this file and displays the variable values by using the echo statement. Both files are placed in the same directory.<\/p>\n
PHP code and markup:<\/strong><\/p>\n
<!doctype html>\r\n<html>\r\n\r\n<head>\r\n\r\n<style>\r\n#timerdiv {\r\n  background: green;\r\n  height: auto;\r\n  width:300px;\r\n  border-radius: 15px;\r\n  padding:20px;\r\n  font-size:16px;\r\n  color:#fff;   \r\n\r\n}\r\n<\/style>\r\n \r\n\r\n  \r\n<\/head>\r\n<body>\r\n<div id=\"timerdiv\"><h3>The demo of PHP include<\/h3>\r\n< ?php \r\ninclude(\"define_variables.php\");\r\n\r\necho \"The value of variable x =\". $x;\r\necho \"<br>The value of variable y =\". $y;\r\n?>\r\n<\/div>\r\n\r\n \r\n<\/body>\r\n<\/html>\r\n<\/pre>\n
Sample output:<\/strong><\/p>\n
\"PHP<\/p>\n
This is how the include statement of PHP is used:<\/p>\n
include(\"define_variables.php\");<\/pre>\n
As included and calling files are placed in the same directory, you simply need to use the file name to include file.<\/p>\n
An example of including an inner directory file<\/strong><\/h3>\n
In this example, the same file containing the variables is stored in an inner directory, \u201cscripts\u201d. This is how the define_variables.php <\/em>file can be included.<\/p>\n
PHP and markup:<\/strong><\/p>\n
<!doctype html>\r\n<html>\r\n\r\n<head>\r\n\r\n<style>\r\n#timerdiv {\r\n  background: #408080;\r\n  height: auto;\r\n  width:300px;\r\n  border-radius: 15px;\r\n  padding:20px;\r\n  font-size:16px;\r\n  color:#fff;   \r\n\r\n}\r\n<\/style>\r\n \r\n\r\n  \r\n<\/head>\r\n<body>\r\n<div id=\"timerdiv\"><h3>PHP include with inner directory<\/h3>\r\n< ?php \r\ninclude(\"scripts\/define_variables.php\");\r\n\r\necho \"The value of variable x =\". $x;\r\necho \"<br>The value of variable y =\". $y;\r\n?>\r\n<\/div>\r\n\r\n \r\n<\/body>\r\n<\/html><\/pre>\n
Sample output:<\/strong><\/p>\n
\"PHP<\/p>\n
The following PHP code is used to include the inner directory:<\/p>\n
include(\"scripts\/define_variables.php\");<\/pre>\n
After including the file, the included file variables are used just like in above example:<\/p>\n
echo \"The value of variable x =\". $x;\r\n\r\necho \"<br>The value of variable y =\". $y;<\/pre>\n
An example to include a backward directory file<\/strong><\/h3>\n
This time, the calling file exists in the inner directory. This is how you will include a file:<\/p>\n
<!doctype html>\r\n<html>\r\n\r\n<head>\r\n\r\n<style>\r\n#timerdiv {\r\n  background: #408080;\r\n  height: auto;\r\n  width:300px;\r\n  border-radius: 15px;\r\n  padding:20px;\r\n  font-size:16px;\r\n  color:#fff;   \r\n\r\n}\r\n<\/style>\r\n \r\n\r\n  \r\n<\/head>\r\n<body>\r\n<div id=\"timerdiv\"><h3>PHP include with calling file in inner directory<\/h3>\r\n< ?php \r\ninclude(\"..\/define_variables.php\");\r\n\r\necho \"The value of variable x =\". $x;\r\necho \"<br>The value of variable y =\". $y;\r\n?>\r\n<\/div>\r\n\r\n \r\n<\/body>\r\n<\/html><\/pre>\n
Output:<\/strong><\/p>\n
\"PHP<\/p>\n
The include statement in above example used as this:<\/p>\n
include(\"..\/define_variables.php\");<\/pre>\n
To go one step back use \u201c..\/\u201d before the file name.<\/p>\n
Using require statement to include files example<\/strong><\/h3>\n
In all above examples, simply replace the word include by require<\/em> to execute the require statement of PHP.<\/p>\n
Using the same PHP file as in above example, this is how\u00a0the require statement will work:<\/p>\n
<!doctype html>\r\n<html>\r\n\r\n<head>\r\n\r\n<style>\r\n#timerdiv {\r\n  background: #800000;\r\n  height: auto;\r\n  width:300px;\r\n  border-radius: 15px;\r\n  padding:20px;\r\n  font-size:16px;\r\n  color:#fff;   \r\n\r\n}\r\n<\/style>\r\n \r\n\r\n  \r\n<\/head>\r\n<body>\r\n<div id=\"timerdiv\"><h3>A demo of PHP require statement<\/h3>\r\n< ?php \r\nrequire(\"define_variables.php\");\r\n\r\necho \"The value of variable x =\". $x;\r\necho \"<br>The value of variable y =\". $y;\r\n?>\r\n<\/div>\r\n\r\n \r\n<\/body>\r\n<\/html>\r\n\r\n<\/pre>\n
Output:<\/strong><\/p>\n
\"PHP<\/p>\n
The require statement is used as follows:<\/p>\n
\n
require(\"define_variables.php\");<\/pre>\n
 <\/p><\/blockquote>\n
What is the output if target file does not exist with include statement?<\/strong><\/h3>\n
As mentioned earlier, if the specified file does not exist, the include statement will generate a warning message. The program will keep on running or would not halt.<\/p>\n
In this example, I mistyped the above file name and see the output (first in case of include statement):<\/p>\n
<!doctype html>\r\n<html>\r\n\r\n<head>\r\n\r\n<style>\r\n#timerdiv {\r\n  background: green;\r\n  height: auto;\r\n  width:300px;\r\n  border-radius: 15px;\r\n  padding:20px;\r\n  font-size:16px;\r\n  color:#fff;   \r\n\r\n}\r\n<\/style>\r\n \r\n\r\n  \r\n<\/head>\r\n<body>\r\n<div id=\"timerdiv\"><h3>Output as File does not exists<\/h3>\r\n< ?php \r\ninclude(\"define_variables12.php\");\r\n\r\necho \"The value of variable x =\". $x;\r\necho \"<br>The value of variable y =\". $y;\r\n?>\r\n<\/div>\r\n\r\n \r\n<\/body>\r\n<\/html><\/pre>\n
Output:<\/strong><\/p>\n
\"PHP<\/p>\n
You see, I called the define_variables12<\/em>.php<\/em> file that does not exist and it simply generated a warning message. While the echo statement from the calling program still executed and displayed:<\/p>\n
The value of variable x =\r\n\r\nThe value of variable y =<\/pre>\n
Now see what happens in the case of require statement:<\/p>\n
<!doctype html>\r\n<html>\r\n\r\n<head>\r\n\r\n<style>\r\n#timerdiv {\r\n  background: #FF0000;\r\n  height: auto;\r\n  width:300px;\r\n  border-radius: 15px;\r\n  padding:20px;\r\n  font-size:16px;\r\n  color:#fff;   \r\n\r\n}\r\n<\/style>\r\n \r\n\r\n  \r\n<\/head>\r\n<body>\r\n<div id=\"timerdiv\"><h3>Output as File does not exist<\/h3>\r\n< ?php \r\nrequire(\"define_variables12.php\");\r\n\r\necho \"The value of variable x =\". $x;\r\necho \"<br>The value of variable y =\". $y;\r\n?>\r\n<\/div>\r\n\r\n \r\n<\/body>\r\n<\/html><\/pre>\n
Output:<\/p>\n
\"PHP<\/p>\n
The following line generated a fatal error:<\/p>\n
require(\"define_variables12.php\");<\/pre>\n
 <\/p>\n
Also, notice in the output, it did not display the echo statement messages as in the case of include statement. Instead, the program was halted.<\/p>\n","protected":false},"excerpt":{"rendered":"
The purpose of include and require statements in PHP The include and require PHP statements are used to include the specified files in the calling file\/program. For example: include(“user_auth.php”); \u00a0 require(“scripts\/db_connect.php”); The code of the specified file will be copied to the calling program before execution by using the include or require statements. This feature … Read more<\/a><\/p>\n","protected":false},"author":1,"featured_media":1071,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[9],"tags":[],"yoast_head":"\nPHP include VS require: explained with different examples<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.jquery-az.com\/php-include-vs-require-explained-with-different-examples\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"PHP include VS require: explained with different examples\" \/>\n<meta property=\"og:description\" content=\"The purpose of include and require statements in PHP The include and require PHP statements are used to include the specified files in the calling file\/program. For example: include("user_auth.php"); \u00a0 require("scripts\/db_connect.php"); The code of the specified file will be copied to the calling program before execution by using the include or require statements. This feature ... Read more\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.jquery-az.com\/php-include-vs-require-explained-with-different-examples\/\" \/>\n<meta property=\"article:published_time\" content=\"2016-03-09T07:59:42+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2023-09-23T12:25:11+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.jquery-az.com\/wp-content\/uploads\/2016\/03\/11.2-PHP-include-inner.png\" \/>\n\t<meta property=\"og:image:width\" content=\"361\" \/>\n\t<meta property=\"og:image:height\" content=\"158\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"jqueryaz\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"jqueryaz\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"7 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.jquery-az.com\/php-include-vs-require-explained-with-different-examples\/\",\"url\":\"https:\/\/www.jquery-az.com\/php-include-vs-require-explained-with-different-examples\/\",\"name\":\"PHP include VS require: explained with different examples\",\"isPartOf\":{\"@id\":\"https:\/\/www.jquery-az.com\/#website\"},\"datePublished\":\"2016-03-09T07:59:42+00:00\",\"dateModified\":\"2023-09-23T12:25:11+00:00\",\"author\":{\"@id\":\"https:\/\/www.jquery-az.com\/#\/schema\/person\/c3f75f86b1c65bf0b93fc46f629fcad3\"},\"breadcrumb\":{\"@id\":\"https:\/\/www.jquery-az.com\/php-include-vs-require-explained-with-different-examples\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.jquery-az.com\/php-include-vs-require-explained-with-different-examples\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.jquery-az.com\/php-include-vs-require-explained-with-different-examples\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.jquery-az.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"PHP include VS require: explained with different examples\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.jquery-az.com\/#website\",\"url\":\"https:\/\/www.jquery-az.com\/\",\"name\":\"\",\"description\":\"PHP, Bootstrap, jQuery, CSS, Python, Java and others\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.jquery-az.com\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.jquery-az.com\/#\/schema\/person\/c3f75f86b1c65bf0b93fc46f629fcad3\",\"name\":\"jqueryaz\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.jquery-az.com\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/e2a3743b4da71bd52984e02bd5c3280c?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/e2a3743b4da71bd52984e02bd5c3280c?s=96&d=mm&r=g\",\"caption\":\"jqueryaz\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"PHP include VS require: explained with different examples","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.jquery-az.com\/php-include-vs-require-explained-with-different-examples\/","og_locale":"en_US","og_type":"article","og_title":"PHP include VS require: explained with different examples","og_description":"The purpose of include and require statements in PHP The include and require PHP statements are used to include the specified files in the calling file\/program. For example: include(\"user_auth.php\"); \u00a0 require(\"scripts\/db_connect.php\"); The code of the specified file will be copied to the calling program before execution by using the include or require statements. This feature ... Read more","og_url":"https:\/\/www.jquery-az.com\/php-include-vs-require-explained-with-different-examples\/","article_published_time":"2016-03-09T07:59:42+00:00","article_modified_time":"2023-09-23T12:25:11+00:00","og_image":[{"width":361,"height":158,"url":"https:\/\/www.jquery-az.com\/wp-content\/uploads\/2016\/03\/11.2-PHP-include-inner.png","type":"image\/png"}],"author":"jqueryaz","twitter_misc":{"Written by":"jqueryaz","Est. reading time":"7 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.jquery-az.com\/php-include-vs-require-explained-with-different-examples\/","url":"https:\/\/www.jquery-az.com\/php-include-vs-require-explained-with-different-examples\/","name":"PHP include VS require: explained with different examples","isPartOf":{"@id":"https:\/\/www.jquery-az.com\/#website"},"datePublished":"2016-03-09T07:59:42+00:00","dateModified":"2023-09-23T12:25:11+00:00","author":{"@id":"https:\/\/www.jquery-az.com\/#\/schema\/person\/c3f75f86b1c65bf0b93fc46f629fcad3"},"breadcrumb":{"@id":"https:\/\/www.jquery-az.com\/php-include-vs-require-explained-with-different-examples\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.jquery-az.com\/php-include-vs-require-explained-with-different-examples\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.jquery-az.com\/php-include-vs-require-explained-with-different-examples\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.jquery-az.com\/"},{"@type":"ListItem","position":2,"name":"PHP include VS require: explained with different examples"}]},{"@type":"WebSite","@id":"https:\/\/www.jquery-az.com\/#website","url":"https:\/\/www.jquery-az.com\/","name":"","description":"PHP, Bootstrap, jQuery, CSS, Python, Java and others","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.jquery-az.com\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/www.jquery-az.com\/#\/schema\/person\/c3f75f86b1c65bf0b93fc46f629fcad3","name":"jqueryaz","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.jquery-az.com\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/e2a3743b4da71bd52984e02bd5c3280c?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/e2a3743b4da71bd52984e02bd5c3280c?s=96&d=mm&r=g","caption":"jqueryaz"}}]}},"_links":{"self":[{"href":"https:\/\/www.jquery-az.com\/wp-json\/wp\/v2\/posts\/1069"}],"collection":[{"href":"https:\/\/www.jquery-az.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.jquery-az.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.jquery-az.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.jquery-az.com\/wp-json\/wp\/v2\/comments?post=1069"}],"version-history":[{"count":3,"href":"https:\/\/www.jquery-az.com\/wp-json\/wp\/v2\/posts\/1069\/revisions"}],"predecessor-version":[{"id":8737,"href":"https:\/\/www.jquery-az.com\/wp-json\/wp\/v2\/posts\/1069\/revisions\/8737"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.jquery-az.com\/wp-json\/wp\/v2\/media\/1071"}],"wp:attachment":[{"href":"https:\/\/www.jquery-az.com\/wp-json\/wp\/v2\/media?parent=1069"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.jquery-az.com\/wp-json\/wp\/v2\/categories?post=1069"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.jquery-az.com\/wp-json\/wp\/v2\/tags?post=1069"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}