Por que usar comentários?
- Se você não trabalhar no código-fonte por algum tempo, é fácil esquecer o que o código faz. Comentar o código-fonte ajuda a lembrar o que o código faz.
- Comentar o código-fonte também é muito importante quando vários desenvolvedores precisam trabalhar no mesmo projeto. As alterações feitas por um desenvolvedor podem ser facilmente compreendidas por outros desenvolvedores simplesmente lendo os comentários.
- Como prática recomendada, você deve ter 3 linhas de comentários para cada 10 linhas de código
Neste tutorial, você aprenderá-
- Comentários PHP
- Incluir PHP e Incluir PHP uma vez
- Exemplo: incluir / incluir uma vez
- Requer PHP e requer_de_uma vez
- Exemplo: Requer
- PHP inclui vs requer
Comentários PHP
- Os comentários nos ajudam a entender o código
- Os comentários são explicações que incluímos em nosso código-fonte. Esses comentários são para a compreensão humana.
- Comentários de linha única começam com barras duplas // e terminam na mesma linha.
- Comentários de várias linhas começam com uma barra seguida do asterisco / * e terminam com o asterisco seguido pela barra * /.
O diagrama abaixo mostra um arquivo PHP com comentários de várias linhas e uma única linha. Exemplo de PHP
Incluir PHP e Incluir PHP uma vez
A instrução php “include” é usada para incluir outros arquivos em um arquivo PHP.
Ele tem duas variações, include e include_once. Include_once é ignorado pelo interpretador PHP se o arquivo a ser incluído.
A instrução de inclusão tem a seguinte sintaxe
A instrução include_once tem a seguinte sintaxe
AQUI,
- “Incluir / incluir_uma vez” é a declaração que inclui o arquivo
- “'File_name'” é o nome do arquivo a ser incluído.
Exemplo: incluir / incluir uma vez
Suponha que você esteja desenvolvendo um site que contém o mesmo menu de navegação em todas as páginas.
Você pode criar um cabeçalho comum e incluí-lo em todas as páginas usando a instrução include. Vamos ver como isso pode ser feito.
- Vamos criar 2 nomes de arquivos
- header.php, index.php
Abaixo estão os códigos para; header.php
HomeAbout usServicesContact Us
index.php
A página de cabeçalho acima irá imprimir
Requer PHP e requer_de_uma vez
A instrução require tem duas variações, require e require_once.
A instrução require / require_once é usada para incluir o arquivo.
Require_once será ignorado se o arquivo necessário já tiver sido adicionado por qualquer uma das quatro instruções de inclusão.
Tem a seguinte sintaxe
AQUI,
- “Require / require_once” é a declaração que inclui o arquivo
- “'File_name'” é o nome do arquivo a ser incluído.
Exemplo: Requer
Suponha que estejamos desenvolvendo um aplicativo baseado em banco de dados.
Podemos criar um arquivo de configuração que podemos incluir em todas as páginas que se conectam ao banco de dados usando a instrução require. config.php
Vamos agora dar uma olhada no código de amostra que requer o arquivo de configuração. Pages_model.php
Php inclui vs requer
A diferença entre incluir / exigir
| Incluir | Requer |
|---|---|
| Emite um aviso quando ocorre um erro | Não emite um aviso |
| A execução do script continua quando ocorre um erro | A execução do script é interrompida quando ocorre um erro. |
Geralmente, é recomendável usar a instrução include para que, quando ocorrer um erro, a execução do script continue exibindo o endereço de e-mail do webmaster ou a página de contato.
A instrução require deve ser usada se o script inteiro não puder ser executado sem o arquivo solicitado.
As instruções “include” e “require” podem ser usadas em qualquer linha nos códigos-fonte onde você deseja que o código apareça.
Resumo
- Um único código HTML, como cabeçalhos, rodapés, barras laterais, etc., pode ser compartilhado em várias páginas. Isso torna mais fácil atualizar o site apenas atualizando um único arquivo.
- O código PHP, como definições de configuração de banco de dados, funções personalizadas, etc., podem ser compartilhados em muitas páginas, garantindo que o site / aplicativo use as mesmas configurações.
- Os comentários são usados para ajudar a entender o código-fonte. Eles são para a compreensão humana
- As declarações de comentário de uma única linha começam com barras duplas //.
- As instruções de comentário de várias linhas são colocadas entre / * instruções * /.
- As declarações “include, include_once, require e require_once” são usadas para incluir arquivos.
- Include_once / require_once será ignorado se o arquivo solicitado já tiver sido incluído usando qualquer uma das quatro instruções.
- A instrução “include” emite um aviso e continua com a execução se o arquivo solicitado não for encontrado.
- A instrução require gera um erro fatal e interrompe a execução do script.
- A instrução “include” deve ser feita na maioria dos casos, exceto em situações em que, sem o arquivo solicitado a ser incluído, o script inteiro não pode ser executado.