Resumo : neste tutorial, você aprenderá como usar a construção require do PHP para carregar o código de um arquivo no script atual.
Introdução ao PHP requer construção
A construção PHP require
carrega o código de um arquivo em um script e executa esse código. O seguinte mostra a sintaxe da require
construção:
<?php
require 'path_to_file';
Linguagem de código: HTML, XML ( xml )
Para carregar o código de um arquivo, especifique o caminho do arquivo após a require
palavra-chave. Ao carregar o arquivo, a require
construção executa o código no arquivo carregado.
A require
construção é igual à include
construção, exceto que, se falhar ao carregar o arquivo, emitirá um erro fatal e interromperá o script, enquanto a include
construção apenas emite um aviso e permite que o script continue.
Na prática, você costuma usar a require
construção para carregar o código das bibliotecas. Como as bibliotecas contêm as funções necessárias para executar o script, é melhor usar a require
construção do que a include
construção.
PHP requer exemplo
Suponha que você tenha index.php
e functions.php
e queira carregar o functions.php
arquivo index.php
.
O functions.php
arquivo tem uma função chamada dd()
, que significa dump e die porque usa as funções var_dump()
e :die()
<?php
if (!function_exists('d')) {
function dd($data)
{
echo '<pre>';
var_dump($data);
echo '</pre>';
die();
}
}
Linguagem de código: HTML, XML ( xml )
O index.php ficará assim:
<?php
require 'functions.php';
dd([1, 2, 3]);
Linguagem de código: HTML, XML ( xml )
Neste arquivo, usamos a require
construção para carregar o código functions.php
que define a dd()
função caso a função não exista. Então, usamos dd()
a função definida no arquivo functions.php
.
PHP require não é uma função
Às vezes, você vê o seguinte código:
<?php
require('functions.php');
Linguagem de código: HTML, XML ( xml )
O código parece uma chamada de função por causa dos parênteses ()
. e funciona.
No entanto, os parênteses não fazem parte da require
construção. Em vez disso, eles pertencem à expressão do caminho do arquivo que está sendo carregado.
PHP require_once
PHP require_once
é a contrapartida do, include_once
exceto que require_once emite um erro se não conseguir carregar o arquivo. Além disso, require_once
não carregará o arquivo novamente se o arquivo tiver sido carregado.
Aqui está a sintaxe da construção require_once:
<?php
require_once 'path_to_file';
Linguagem de código: HTML, XML ( xml )
Resumo
- Use
require
construct para carregar o código de outro arquivo no script. - Use
require_once
construct para carregar o código de outro arquivo uma vez e não incluirá o arquivo novamente se o arquivo tiver sido carregado. - Os
require
erequire_once
são construções de linguagem, não funções.