corner imagecorner image
IDEPlatformPluginsDocs & SupportCommunityPartners

Criando um aplicativo controlado por banco de dados com PHP

Lição 3: Criando um novo usuário de aplicativo

O conteúdo desta página se aplica ao IDE NetBeans 6.9-7.0

Nesta lição, você expande o aplicativo com a funcionalidade Create a New Wisher.

A implementação afetará o arquivo index.php e os dois novos arquivos criados se chamarão createNewWisher.php e editWishList.php.

O caso de uso Create a New Wisher consiste em duas etapas:

1. O usuário abre a página inicial index.php e clica no link para registrar.

2. O usuário alterna para a página createNewWisher.php para criar um novo criador de lista de desejos.

3. Depois de criar um novo criador de lista de desejos, o usuário alternar para editWishList.php, no qual cria uma lista de desejos para o usuário.

Diagrama de fluxo da página destacando os novos arquivos criados na lição 3

O documento atual é uma parte do tutorial Criando um aplicativo CRUD no NetBeans IDE para PHP.


Código-fonte do aplicativo da lição anterior

Usuários do MySQL: clique aqui para baixar o código-fonte que reflete o estado do projeto depois que a lição anterior estiver concluída.

Usuários do banco de dados Oracle: clique aqui para baixar o código-fonte que reflete o estado do projeto depois que a lição anterior estiver concluída.

Adicionando um link para começar a criar um novo criador de lista de desejos

Abra index.php. Adicione uma linha em branco abaixo da marca </form> de fechamento. Na linha em branco, insira o seguinte bloco de código:
 <br>Ainda não tem uma lista de desejos?! <a href="createNewWisher.php">Criar agora</a>

Onde:

  • Ainda não tem uma lista de desejos?! é o texto exibido na página ao lado do link.
  • <a href="createNewWisher.php"></a> é o código que implementa um link que abre a página createNewWisher.php.
  • Criar agora é o texto exibido como um link.

Criando novos arquivos PHP

Crie dois novos arquivos PHP nos arquivos de código-fonte do projeto, como descrito na Lição 2.

  • createNewWisher.php
  • editWishList.php

Em editWishList.php, adicione o texto "Hello!" ao corpo HTML ou deixe o conteúdo padrão. Você modificará esse arquivo em lições posteriores, mas você precisa dele agora porque createNewWisher.php faz referência a ele. Para o restante desta lição, você modifica createNewWisher.php.

Adicionando um formulário HTML para indicar os dados de um novo criador de lista de desejos

Digite ou cole o seguinte bloco HTML no createNewWisher.php, abaixo do bloco PHP:

<html>
    <head>
        <meta http-equiv="content-type" content="text/html; charset=UTF-8">
    </head>
    <body>
Bem-vindo!<br>
<form action="createNewWisher.php" method="POST">
Your name: <input type="text" name="user"/><br/>
Password: <input type="password" name="password"/><br/>
Please confirm your password: <input type="password" name="password2"/><br/>
<input type="submit" value="Register"/>
</form>
</body></html>

Observação: O tipo password é um tipo especial de um campo de texto onde os caracteres são substituídos por asteriscos. O código apresenta um formulário HTML para um usuário indicar o nome e a senha do novo criador de lista de desejos nos campos de texto. Quando o usuário clica no botão "Registro", os dados indicados são transferidos para validação na mesma página, createNewWisher.php.

Nota: você pode ignorar os avisos do validador HTML.

Validando dados e adicionando-os ao banco de dados

Nesta seção, você adiciona o código PHP a createNewWisher.php. Adicione este código ao bloco PHP na parte superior do código. O bloco PHP deve estar acima de todo o código HTML , linhas vazias ou espaço em branco. A posição do bloco de código PHP é importante para permitir o correto funcionamento da instrução de redirecionamento. No bloco PHP, digite ou cole os blocos de código descritos abaixo desta seção, na ordem em que eles são escritos.

Adicione o código seguinte para validar os dados:

  1. Inicialize as variáveis. As primeiras variáveis passam as credenciais do banco de dados e as outras serão usadas nas operações PHP.
    /** database connection credentials */
    $dbHost="localhost";
    $dbUsername="phpuser";
    $dbPasswd="phpuserpw"; /** other variables */ $userNameIsUnique = true; $passwordIsValid = true; $userIsEmpty = false; $passwordIsEmpty = false; $password2IsEmpty = false;
  2. Abaixo das variáveis, adicione uma cláusula if . O parâmetro da cláusula if verifica se a página foi solicitada a partir dela mesma através do método POST. Caso contrário, as validações posteriores não são realizadas e a página é mostrada com campos vazios, como descrito acima.
    if ($_SERVER["REQUEST_METHOD"] == "POST") {
    
    }
  3. Dentro das chaves da cláusula if , adicione outra cláusula if que verifica se o usuário preencheu o nome do criador da lista de desejos. Se o campo de texto "user" estiver vazio, o valor de $userIsEmpty será alterado para true.
    if ($_SERVER["REQUEST_METHOD"] == "POST") {
    
        
        if ($_POST["user"]=="")
        $userIsEmpty = true;
    }
  4. Adicione o código que estabelece uma conexão de banco de dados. Se não for possível estabelecer a conexão, o erro MySQL ou Oracle OCI8 é enviado para a saída.

    No banco de dados MySQL:

    if ($_SERVER["REQUEST_METHOD"] == "POST") {
    
        
        if ($_POST["user"]=="") {
            $userIsEmpty = true;
        }
        $con = mysqli_connect("localhost", "phpuser", "phpuserpw");
    if (!$con) {
    exit('Connect Error (' . mysqli_connect_errno() . ') '
    . mysqli_connect_error());
    }
    //set the default client character set
    mysqli_set_charset($con, 'utf-8');
    }

    No banco de dados Oracle:

    if ($_SERVER['REQUEST_METHOD'] == "POST") {
        if ($_POST['user'] == "")
            $userIsEmpty = true;
        $con = oci_connect("phpuser", "phpuserpw", "localhost/XE");
        if (!$con) {
            $m = oci_error();
            exit('Connect Error' . $m['message']);
    
        }
    }
  5. Adicione o código que verifica se um usuário cujo nome corresponde ao campo "user" já existe. O código faz isso, tentando localizar o número do ID de um criador da lista de desejos para um nome correspondente ao nome no campo "user". Se houver tal número de ID, o valor de $userNameIsUnique é alterado para "false."

    No banco de dados MySQL:

    if ($_SERVER["REQUEST_METHOD"] == "POST") {
    
    Displaying error messages if ($_POST["user"]=="") { $userIsEmpty = true; }

    $con = mysqli_connect("localhost", "phpuser", "phpuserpw");
    if (!$con) {
    exit('Connect Error (' . mysqli_connect_errno() . ') '
    . mysqli_connect_error());
    }
    //set the default client character set
    mysqli_set_charset($con, 'utf-8');
    mysqli_select_db($con, "wishlist"); $user = mysqli_real_escape_string($con, $_POST["user"]);
    $wisher = mysqli_query($con, "SELECT id FROM wishers WHERE name='".$usuário."'");
    $wisherIDnum=mysqli_num_rows($wisher);
    if ($wisherIDnum) {
    $userNameIsUnique = false;
    }
    }

    No banco de dados Oracle:

    if ($_SERVER['REQUEST_METHOD'] == "POST") {
        if ($_POST['user'] == "")
            $userIsEmpty = true;
        $con = oci_connect("phpuser", "phpuserpw", "localhost");
        if (!$con) {
            $m = oci_error();
            exit('Connection Error ' . $m['message']);
    
        }
        $query = "SELECT id FROM wishers WHERE name = :user_bv";
        $stid = oci_parse($con, $query);
        $user = $_POST['user'];
        $wisherID = null;
        oci_bind_by_name($stid, ':user_bv', $user);
        oci_execute($stid);
    
    // Each user name should be unique. Check if the submitted user already exists.
        $row = oci_fetch_array($stid, OCI_ASSOC);
        if ($row){
            $userNameIsUnique = false;
        }
    }
  6. Depois do código que verifica se o usuário é único, adicione uma série de cláusulas if que verifica se o usuário introduziu e confirmou corretamente uma senha. O código verifica se os campos Senha ("password") e Confirmar senha ('password2) não estão vazios no formulário e não são idênticos. Caso contrário, os valores das variáveis booleanas correspondentes são alterados de acordo.
    if ($_POST["password"]=="")
    $passwordIsEmpty = true;
    if ($_POST["password2"]=="")
    $password2IsEmpty = true;
    if ($_POST["password"]!=$_POST["password2"]) {
    $passwordIsValid = false;}
  7. Complete a cláusula if ($_SERVER['REQUEST_METHOD'] == "POST"), adicionando o código que insere uma nova entrada no banco de dados "wishers". O código verifica se o nome do criador da lista de desejos é especificado exclusivamente e se a senha é indicada e confirmada validamente. Se as condições forem atendidas, o código pegará os valores "user" e "password" do formulário HTML e os inserirá nas colunas Nome e Senha, respectivamente, de uma nova linha no banco de dados wishers. Depois de criar a linha, o código fecha a conexão do banco de dados e redireciona o aplicativo para a página editWishList.php.

    No banco de dados MySQL:

    /** Check that the page was requested from itself via the POST method. */
    if ($_SERVER['REQUEST_METHOD'] == "POST") {
        /** Check whether the user has filled in the wisher's name in the text field "user" */
        if ($_POST['user'] == "") {
            $userIsEmpty = true;
        }
    
        /** Create database connection */
        $con = mysqli_connect("localhost", "phpuser", "phpuserpw");
        if (!$con) {
            exit('Connect Error (' . mysqli_connect_errno() . ') '
                    . mysqli_connect_error());
        }
        //set the default client character set 
        mysqli_set_charset($con, 'utf-8');
    
        /** Check whether a user whose name matches the "user" field already exists */
        mysqli_select_db($con, "wishlist");
        $user = mysqli_real_escape_string($con, $_POST['user']);
        $wisher = mysqli_query($con, "SELECT id FROM wishers WHERE name='".$usuário."'");
        $wisherIDnum=mysqli_num_rows($wisher);
        if ($wisherIDnum) {
            $userNameIsUnique = false;
        }
    
        /** Check whether a password was entered and confirmed correctly */
        if ($_POST['password'] == "")
            $passwordIsEmpty = true;
        if ($_POST['password2'] == "")
            $password2IsEmpty = true;
        if ($_POST['password'] != $_POST['password2']) {
            $passwordIsValid = false;
        }
    
        /** Check whether the boolean values show that the input data was validated successfully.
         * If the data was validated successfully, add it as a new entry in the "wishers" database.
         * After adding the new entry, close the connection and redirect the application to editWishList.php.
         */
        if (!$userIsEmpty && $userNameIsUnique && !$passwordIsEmpty && !$password2IsEmpty && $passwordIsValid) {
            $password = mysqli_real_escape_string($con, $_POST['password']);
            mysqli_select_db($con, "wishlist");
            mysqli_query($con, "INSERT wishers (name, password) VALUES ('" . $usuário . "', '" . $password . "')");
            mysqli_free_result($wisher);
            mysqli_close($con);
            header('Location: editWishList.php');
            exit;
        }
    }

    No banco de dados Oracle:

    if ($_SERVER['REQUEST_METHOD'] == "POST") {
        if ($_POST['user'] == "")
            $userIsEmpty = true;
        $con = oci_connect("phpuser", "phpuserpw", "localhost/XE", "AL32UTF8");
        if (!$con) {
            $m = oci_error();
            echo $m['message'], "\n";
            exit;
        }
        $query = "select ID from wishers where name = :user_bv";
        $stid = oci_parse($con, $query);
        $user = $_POST['user'];
        $wisherID = null;
        oci_bind_by_name($stid, ':user_bv', $user);
        oci_execute($stid);
    
    //Each user name should be unique. Check if the submitted user already exists.
        $row = oci_fetch_array($stid, OCI_ASSOC);
        if ($row) {
        $wisherID = $row['ID']; 
        }
        if ($wisherID != null) {
            $userNameIsUnique = false;
        }
        //Check for the existence and validity of the password
        if ($_POST['password'] == "")
            $passwordIsEmpty = true;
        if ($_POST['password2'] == "")
            $password2IsEmpty = true;
        if ($_POST['password'] != $_POST['password2']) {
            $passwordIsValid = false;
        }
        /** Check whether the boolean values show that the input data was validated successfully.
         * If the data was validated successfully, add it as a new entry in the "wishers" database.
         * After adding the new entry, close the connection and redirect the application to editWishList.php.
         */
        if (!$userIsEmpty && $userNameIsUnique && !$passwordIsEmpty && !$password2IsEmpty && $passwordIsValid) {
    
            $query = "INSERT INTO wishers (name, password) VALUES (:user_bv, :pwd_bv)";
            $stid = oci_parse($con, $query);
            $pwd = $_POST['password'];
            oci_bind_by_name($stid, ':user_bv', $user);
            oci_bind_by_name($stid, ':pwd_bv', $pwd);
            oci_execute($stid);
            oci_free_statement($stid);
            oci_close($con);
            header('Location: editWishList.php');
            exit;
        }
    }

Exibindo mensagens de erro no formulário de entrada

Agora você implementa a exibição das mensagens de erro quando os dados indicados são inválidos. A implementação é baseada nas validações e alterações nos valores das variáveis booleanas descritas em Validando dados e adicionando-os ao banco de dados.

  1. Indique o seguinte bloco de código PHP dentro do formulário de entrada HTML, abaixo da entrada do nome do criador da lista de desejos:
    Bem-vindo!<br>
    <form action="createNewWisher.php" method="POST">
    Your name: <input type="text" name="user"/><br/>
    <?php if ($userIsEmpty) { echo ("Enter your name, please!"); echo ("<br/>"); } if (!$userNameIsUnique) { echo ("The person already exists. Please check the spelling and try again"); echo ("<br/>"); } ?>
  2. Indique o seguinte bloco de código PHP dentro do formulário de entrada HTML abaixo do código da entrada de senha:
    Password: <input type="password" name="password"/><br/>
    
    <?php if ($passwordIsEmpty) { echo ("Enter the password, please!"); echo ("<br/>"); } ?>
  3. Indique os seguintes blocos de código PHP dentro do formulário de entrada HTML abaixo do código de confirmação de senha:
    Please confirm your password: <input type="password" name="password2"/><br/>
    
    
    
    <?php if ($password2IsEmpty) { echo ("Confirm your password, please"); echo ("<br/>"); } if (!$password2IsEmpty && !$passwordIsValid) { echo ("The passwords do not match!"); echo ("<br/>"); } ?>

Testando a funcionalidade Create New Wisher

  1. Execute o aplicativo. A página de índice se abre.
    A página principal do aplicativo index.php com duas opções: Visualizando a lista de desejos de uma pessoa e criando uma lista de desejos
  2. Na página de índice, clique no link ao lado do texto Ainda não possui uma lista de desejos? O formulário seguinte se abre:
    Um formulário vazio para se registrar como um criador de lista de desejos
  3. Deixe os campos vazios e clique em OK. Uma mensagem de erro é exibida
    O formulário de registro do criador da lista de desejos com uma mensagem de erro: o nome não está preenchido
  4. Indique o nome de um criador de lista de desejos registrado, por exemplo, Tom no campo Seu nome, preencha os outros campos corretamente e clique em Registrar. Uma mensagem de erro é exibida
  5. Preencha os campos Senha e Confirme sua senha com valores diferentes e clique em Registrar. Uma mensagem de erro é exibida
  6. Indique Bob no campo Seu nome, especifique a mesma senha em ambos os campos de senha e clique em Registrar. A página que se abre está vazia mas o redirecionamento foi passado corretamente já que a URL termina com editWishList.php:
    A página editWishList.php com uma saudação de boas-vindas
  7. Para verificar se os dados estão armazenados no banco de dados, vá para wishers na janela Serviços abaixo do nó wislist1 e no menu de contexto, escolha Visualizar dados
    Visualizando os dados no banco de dados usando a interface do NetBeans IDE: o novo criador de lista de desejos Bob foi adicionado

O código-fonte do aplicativo após a lição atual está concluído

Usuários do MySQL: clique aqui para baixar o código-fonte que reflete o estado do projeto depois que a lição estiver concluída.

Usuários do banco de dados Oracle: clique aqui para baixar o código-fonte que reflete o estado do projeto depois que a lição estiver concluída.

Próximas etapas

<< Lição anterior

Próxima lição >>

Voltar à página principal do tutorial



Para enviar comentários e sugestões, obter suporte e manter-se informado sobre os desenvolvimentos mais recentes dos recursos de desenvolvimento em PHP no NetBeans IDE, junte-se à lista de usuários .

Voltar à trilha do aprendizado PHP