CRUD básico inicial Codeigniter 4 - users

Este é um exemplo mínimo de como iniciar um #CRUD com #Codeigniter 4.
Vamos criar o Create, Update, Delete e Read de uma table users.

Primeiro instalamos o projeto. Instruções em: https://www.codeigniter.com/user_guide/installation/installing_composer.html

*Para este pequeno tutorial estamos considerando que seu ambiente de desenvolvimento já está configurado. Caso não esteja pesquise sobre como startar o PHP ou instale um servidor como WAMP, Apache ou Laragon ou, ainda, uma outra solução que te ajude nos testes.

composer create-project codeigniter4/appstarter project-root

Criamos o banco de dados e a table users

CREATE DATABASE `ci4-entity` /*!40100 DEFAULT CHARACTER SET utf8mb4 */;

-- `ci4-entity`.users definition

CREATE TABLE `users` (
 `id` int(11) NOT NULL AUTO_INCREMENT,
 `name` varchar(255) NOT NULL,
 `email` varchar(255) NOT NULL,
 `password` varchar(255) NOT NULL,
 `status` varchar(50) DEFAULT NULL,
 `created_at` datetime DEFAULT CURRENT_TIMESTAMP,
 `updated_at` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
 `deleted_at` datetime DEFAULT NULL,
 PRIMARY KEY (`id`),
 UNIQUE KEY `email` (`email`)
) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8mb4;

app/Config/Routes.php

$routes->get('user', 'UserController::index'); // Listar todos os usuários
$routes->get('user/create', 'UserController::create'); // Formulário de criação de usuário
$routes->post('user/store', 'UserController::store'); // Salvar novo usuário
$routes->get('user/edit/(:num)', 'UserController::edit/$1'); // Formulário de edição de usuário
$routes->post('user/update/(:num)', 'UserController::update/$1'); // Atualizar usuário
$routes->get('user/delete/(:num)', 'UserController::delete/$1'); // Excluir usuário

app/Controllers/UserController.php

<?php
// app/Controllers/UserController.php
namespace App\Controllers;

use App\Models\UserModel;
use App\Entities\User;

class UserController extends BaseController
{
 public function index()
 {
 $userModel = new UserModel();

 // Configurando a paginação
 $data = [
 'users' => $userModel->paginate(10), // 10 usuários por página
 'pager' => $userModel->pager
 ];

 return view('user/index', $data);
 }

 public function create()
 {
 return view('user/create');
 }

 public function edit($id)
 {
 $userModel = new UserModel();
 $data['user'] = $userModel->find($id);
 return view('user/edit', $data);
 }

 public function update($id)
 {
 $userModel = new UserModel();
 $data = $this->request->getPost();

 // Verifica se a senha foi fornecida
 if (!empty($data['password'])) {
 $data['password'] = password_hash($data['password'], PASSWORD_DEFAULT);
 } else {
 // Se a senha não foi fornecida
 unset($data['password']);
 }

 // Atualiza os dados do usuário
 $userModel->update($id, $data);

 return redirect()->to('/user');
 }

 public function delete($id)
 {
 $userModel = new UserModel();
 $userModel->delete($id);
 return redirect()->to('/user')->with('message', 'Usuário excluído com sucesso');
 }

 public function store()
 {
 $userModel = new UserModel();

 $user = new User($this->request->getPost());
 $user->setPassword($this->request->getPost('password'));

 if ($userModel->save($user)) {
 return redirect()->to('/user/success');
 } else {
 var_dump($userModel->errors());
 die();
 // return redirect()->back()->withInput()->with('errors', $userModel->errors());
 }
 }
}

// app/Entities/User.php

<?php
// app/Entities/User.php
namespace App\Entities;

use CodeIgniter\Entity\Entity;

class User extends Entity
{
 protected $attributes = [
 'id' => null,
 'name' => null,
 'email' => null,
 'password' => null,
 'status' => null,
 ];

 protected $dates = ['created_at', 'updated_at'];

 // Método para setar a senha com hash
 public function setPassword(string $password)
 {
 $this->attributes['password'] = password_hash($password, PASSWORD_DEFAULT);
 return $this;
 }
}

// app/Models/UserModel.php

<?php
// app/Models/UserModel.php
namespace App\Models;

use CodeIgniter\Model;

class UserModel extends Model
{
 protected $table = 'users';
 protected $primaryKey = 'id';
 protected $returnType = 'App\Entities\User';
 protected $useSoftDeletes = true;
 protected $allowedFields = ['name', 'email', 'password', 'status'];
 protected $useTimestamps = true;
 protected $createdField = 'created_at';
 protected $updatedField = 'updated_at';
 protected $deletedField = 'deleted_at';
}

app/Views/user/index.php

<!-- app/Views/user/index.php -->
<!DOCTYPE html>
<html>

<head>
 <title>Lista de Usuários</title>
</head>

<body>
 <h1>Lista de Usuários</h1>
 <table>
 <thead>
 <tr>
 <th>ID</th>
 <th>Nome</th>
 <th>Email</th>
 <th>Status</th>
 <th>Ações</th>
 </tr>
 </thead>
 <tbody>
 <?php foreach ($users as $user) : ?>
 <tr>
 <td><?= esc($user->id) ?></td>
 <td><?= esc($user->name) ?></td>
 <td><?= esc($user->email) ?></td>
 <td><?= esc($user->status) ?></td>
 <td>
 <a href="/user/edit/<?= $user->id ?>">Editar</a>
 <a href="/user/delete/<?= $user->id ?>" onclick="return confirm('Tem certeza?')">Excluir</a>
 </td>
 </tr>
 <?php endforeach; ?>
 </tbody>
 </table>

 <!-- Links de Paginação -->
 <?= $pager->links() ?>
</body>

</html>

app/Views/user/edit.php

<!-- app/Views/user/edit.php -->
<!DOCTYPE html>
<html>

<head>
 <title>Editar Usuário</title>
</head>

<body>
 <h1>Editar Usuário</h1>
 <?php if (session()->getFlashdata('errors')) : ?>
 <div>
 <?php foreach (session()->getFlashdata('errors') as $error) : ?>
 <p><?= esc($error) ?></p>
 <?php endforeach ?>
 </div>
 <?php endif ?>
 <form action="<?= site_url(); ?>/user/update/<?= $user->id ?>" method="post">
 <?= csrf_field() ?>
 <label for="name">Nome:</label>
 <input type="text" name="name" id="name" value="<?= esc($user->name) ?>"><br>

 <label for="email">Email:</label>
 <input type="email" name="email" id="email" value="<?= esc($user->email) ?>"><br>

 <label for="password">Senha (deixe em branco para não alterar):</label>
 <input type="password" name="password" id="password"><br>

 <label for="status">Status:</label>
 <input type="text" name="status" id="status" value="<?= esc($user->status) ?>"><br>

 <button type="submit">Atualizar</button>
 </form>
</body>

</html>

app/Views/user/create.php

<!-- app/Views/user/create.php -->
<!DOCTYPE html>
<html>

<head>
 <title>Cadastro de Usuário</title>
</head>

<body>
 <h1>Cadastro de Usuário</h1>
 <?php if (session()->getFlashdata('errors')) : ?>
 <div>
 <?php foreach (session()->getFlashdata('errors') as $error) : ?>
 <p><?= esc($error) ?></p>
 <?php endforeach ?>
 </div>
 <?php endif ?>
 <form action="<?= site_url(); ?>/user/store" method="post">
 <?= csrf_field() ?>
 <label for="name">Nome:</label>
 <input required type="text" name="name" id="name" value="<?= old('name') ?>"><br>

 <label for="email">Email:</label>
 <input required type="email" name="email" id="email" value="<?= old('email') ?>"><br>

 <label for="password">Senha:</label>
 <input type="password" name="password" id="password"><br>

 <label for="status">Status:</label>
 <input required type="text" name="status" id="status" value="<?= old('status') ?>"><br>

 <button type="submit">Cadastrar</button>
 </form>
</body>

</html>

Este é apenas um simples exemplo de como é possível fazer um #CRUD com poucas linhas utilizando o #framework #Codeigniter 4 e #entity .
Ccompletar a solução vai além. É preciso processar os dados de entrada, tratá-los e validá-los. Também podemos adicionar o controle para verificar se o cadastro já existe e melhorar o feedback do usuário com alertas customizados como estes https://www.codesnippets.dev.br/post/ideias-para-alerts-com-informacoes-bootstrap-5.