Comentários PHP, Incluir/Incluir_once, Exigir/Exigir_once

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

Comentários PHP

  • Os comentários nos ajudam a entender o código
  • Comentários são explicações que incluímos em nosso código-fonte. Esses comentários são para compreensão humana.
  • Comentários de linha única começam com double barras // e terminam na mesma linha.
  • Comentários PHP
  • Comentários de várias linhas começam com uma barra seguida pelo asterisco /* e terminam com o asterisco seguido pela barra */.
  • Comentários PHP

O diagrama abaixo mostra um arquivo PHP com comentários de múltiplas linhas e de uma única linha

Exemplo de PHP

Exemplo de comentários PHP

PHP Incluir e PHP Incluir_once

A instrução “include” php é usada para incluir outros arquivos em um arquivo PHP.

Possui duas variações, include e include_once. Include_once é ignorado pelo interpretador PHP se o arquivo for incluído.

A instrução include tem o seguintewing sintaxe

<?php
include 'file_name';
?>

A instrução include_once tem o seguintewing sintaxe

<?php
include_once 'file_name';
?>

AQUI,

  • “Include/include_once” é a instrução que inclui o arquivo
  • “'file_name'” é o nome do arquivo a ser incluído.

Exemplo: Incluir / Incluir_once

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 cada página usando a instrução include. Vamos ver como isso pode ser feito.

  • Criaremos 2 nomes de arquivos
  • cabeçalho.php, index.php

Abaixo estão os códigos para; header.php

<a href="index.php">Home</a>

<a href="aboutus.php">About us</a>

<a href="services.php">Services</a>

<a href="contactus.php">Contact Us</a>

index.php

<?php

include 'header.php';

?>

A página de cabeçalho acima irá gerar

PHP requer e PHP require_once

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 include.

Tem o seguintewing sintaxe

<?php
require 'file_name';
?>
<?php
require_once 'file_name';
?>

AQUI,

  • “require/require_once” é a instrução que inclui o arquivo
  • “'file_name'” é o nome do arquivo a ser incluído.

Exemplo: Exigir

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

<?php

$config['host'] = 'localhost';

$config['db'] = 'my_database';

$config['uid'] = 'root';

$config['password'] = '';

?>

Vejamos agora o código de exemplo que requer o arquivo de configuração. Páginas_model.php

<?php

require 'config.php'; //require the config file

//other code for connecting to the database

?>

PHP inclui vs exige

A diferença entre incluir/exigir

Incluir Exigir
Emite um aviso quando ocorre um erro Não emite aviso
A execução do script continua quando ocorre um erro A execução do script é interrompida quando ocorre um erro.

Geralmente, é recomendado usar a instrução include para que quando ocorrer um erro, a execução do script continue exibindo o webmaster email endereço 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 dos códigos-fonte onde você deseja que o código apareça.

Resumo

  • Código HTML único, como cabeçalhos, rodapés, barras laterais, etc., pode ser compartilhado em muitas páginas. Isso facilita a atualização do site, atualizando apenas um único arquivo.
  • Código PHP como configurações 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.
  • Comentários são usados ​​para ajudar a entender o código-fonte. Eles são para a compreensão humana
  • Declarações de comentários de linha única começam com double barras //.
  • Instruções de comentários multilinhas são colocadas entre instruções /* */.
  • As instruçõ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 caso o arquivo solicitado não tenha sido encontrado.
  • A instrução require gera um erro fatal e interrompe a execução do script.
  • A instrução “include” deve ser usada na maioria dos casos, exceto em situações em que, sem o arquivo solicitado a ser incluído, o script inteiro não poderá ser executado.