Nesta parte do tutorial vamos aprender a criar arquivos .php contendo funções, constantes e outros recursos para reuso em nossas aplicações escritas em PHP.

Para acompanhar esta parte do tutorial é necessário instalar umas das IDEs listadas em PHP Básico: Introdução ou utilizar alguma compilador online que tenha suporte a criação de arquivos .php em seu ambiente, como o OnlineGDB.

Como PHP é executado em um ambiente Web, as bibliotecas do usuário devem ser armazenadas em pastas que apenas a aplicação do usuário possua acesso restrito. Assim, as bibliotecas não ficam acessíveis/disponíveis para acesso do lado do cliente(client-side).

Utilizando uma IDE ou compilador PHP online, vamos criar uma arquivo .php chamado biblioteca.php contendo apenas as tags PHP de abertura e fechamento.

O arquivo .php deve ser criado na mesma pasta do arquivo main.php que já deve ter sido criado pela IDE ou um compilador online.

Exemplo 1

//biblioteca.php
<?php
    //corpo 
?>

Vamos adicionar uma função chamada funcao, e um constante chamada CONSTANTE em nosso arquivo biblioteca.php como pode ser visto no exemplo abaixo:

Exemplo 2

<?php
    define("CONSTANTE",999);
    
    function funcao($param){
        echo "Hello World";        
    }
?>

Para ter acesso aos recursos contidos em nossa biblioteca.php, precisamos incluí-la no topo de nosso arquivo main.php utilizando o comando include como abaixo:

Sintaxe

include("nome_arquivo.php");

Exemplo 3

//main.php
<?php
    include("biblioteca.php");
    //uso de recursos da biblioteca
?>

Com os arquivos criados, biblioteca importada, vamos utilizar os recursos de nossa biblioteca.php como mostrado no exemplo baixo:

Exemplo 4

//biblioteca.php
<?php
    define("CONSTANTE",999);
    
    function funcao($param){
        echo "Olá da biblioteca\n",Argumento:$param;        
    }
?>

//main.php
<?php
    include("biblioteca.php");

    echo "constante:",CONSTANTE;
    funcao(999);
?>

Saída

constante:999
Olá da biblioteca
Argumento:999

Com o básico que foi aprendido aqui, podemos criar nossas pequenas bibliotecas para reuso, separação de responsabilidade e organização de nossas aplicações criadas em PHP.

É importante observar que todos os recurso criados em arquivo .php ficam públicos sem nenhum tipo de restrição de acesso quando importamos com uso do include.

Para reforçar a compreensão da criação de uma biblioteca do usuário, vamos criar uma calculadora básica de inteiros contendo as operações: adição, subtração, divisão e multiplicação.

No arquivo calculadora.php onde vão ficar armazenadas as funções da calculadora, vamos declarar as funções aritméticas básicas como mostrado no exemplo abaixo:

Exemplo 5

<?php
    function adi($p1, $p2) : int 
    {
        return $p1 + $p2;       
    }
    
    function sub($p1, $p2): int
    {
        return $p1 - $p2;
    }
    
    function div($p1, $p2): int
    {
        return $p1 * $p2;        
    }

    //necessário validar divisão por zero
    function mul($p1, $p2): int
    {
        return $p1 / $p2;        
    }
?>

No arquivo main.php, vamos adicionar o include, como visto acima, do arquivo calculadora.php e fazer uso de suas funções; adi, sub, div e mul:

Exemplo 5

<?php
    include("calculadora.php");

    echo adi(1,2),"\n";
    echo sub(3,2),"\n";
    echo mul(2,2),"\n";
    echo div(4,2),"\n";
?>

Saída

3
1
1
8

1. 22/08/2025 - revisão 3 - Ajustes: pontuais, sintaxes e targets de links; Adição: calculadora
2. 22/09/2024 - revisão 2 - ajustes gramaticais pontuais e outros ajustes
3. 05/02/2024 - revisão 1 - correção em navegação e erros gramaticais
4. 20/09/2023 - versão inicial