PHP requer

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 requirecarrega o código de um arquivo em um script e executa esse código. O seguinte mostra a sintaxe da requireconstruçã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 requirepalavra-chave. Ao carregar o arquivo, a requireconstrução executa o código no arquivo carregado.

A requireconstrução é igual à includeconstrução, exceto que, se falhar ao carregar o arquivo, emitirá um erro fatal e interromperá o script, enquanto a includeconstrução apenas emite um aviso e permite que o script continue.

Na prática, você costuma usar a requireconstruçã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 requireconstrução do que a includeconstrução.

PHP requer exemplo

Suponha que você tenha index.phpe functions.phpe queira carregar o functions.phparquivo index.php.

O functions.phparquivo 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 requireconstrução para carregar o código functions.phpque 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 requireconstruçã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_onceexceto que require_once emite um erro se não conseguir carregar o arquivo. Além disso, require_oncenã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 requireconstruct para carregar o código de outro arquivo no script.
• Use require_onceconstruct para carregar o código de outro arquivo uma vez e não incluirá o arquivo novamente se o arquivo tiver sido carregado.
• Os requiree require_oncesão construções de linguagem, não funções.