Criando e Executando um Projeto Phalcon

O que é Phalcon?

Phalcon é um framework PHP de alto desempenho, implementado como uma extensão C, fornecendo eficiência extrema na execução. Ele adota a arquitetura MVC (Modelo-Visão-Controlador), com o objetivo de oferecer uma experiência de desenvolvimento rápida e flexível, ao mesmo tempo que mantém alto desempenho.

Principais características e vantagens do Phalcon

Alto Desempenho: Sendo implementado como uma extensão C, Phalcon oferece um desempenho excelente.
Funcionalidades Ricas: Inclui ORM, motor de templates, roteamento, cache, filas e muito mais, atendendo a diversas necessidades de desenvolvimento.
Baixo Consumo de Memória: Graças ao seu método de implementação único, Phalcon consome pouca memória em tempo de execução.
Fácil de Usar: Fornece uma API simples e fácil de usar e documentação clara, auxiliando desenvolvedores a começar rapidamente.
Design Modular: É possível escolher e usar diferentes componentes conforme necessário, oferecendo elevada flexibilidade.

Phalcon é uma escolha ideal para construir aplicações Web de alto desempenho e APIs, adequando-se a projetos de pequeno porte até sistemas empresariais de grande escala.

Criando e Executando um Projeto Phalcon com o ServBay

Neste artigo, usaremos o ambiente PHP fornecido pelo ServBay para criar e executar um projeto Phalcon. Iremos utilizar a função 'Hospedagem' do ServBay para configurar o servidor Web e acessar o projeto através de configurações simples.

Atenção: Se você já foi usuário do NGINX ou Apache

O ServBay usa o Caddy como servidor Web por padrão. Para usuários que estão migrando do NGINX e Apache para o ServBay, há algumas mudanças importantes a serem observadas:

Configuração do Caddy
O ServBay já vem com o Caddy embutido e sua configuração padrão já está otimizada. Os desenvolvedores apenas precisam usar a função 'Hospedagem' do ServBay para gerenciar os sites, sem precisar modificar manualmente os arquivos de configuração do Caddy.
Regras de Reescrita e .htaccess
No NGINX e Apache, os desenvolvedores geralmente precisam escrever suas próprias regras de reescrita e arquivos .htaccess para tratar as reconfigurações de URL e outras configurações. No entanto, o ServBay vem configurado com essas regras no Caddy, então, a menos que haja uma necessidade especial, os desenvolvedores não precisam escrever essas regras.
Saiba Mais
Para mais informações, consulte Reescrita e htaccess, Como Migrar um Site do Apache para ServBay, Como Migrar um Site do NGINX para ServBay.

Atenção: Habilitando o Módulo Phalcon

O ServBay já vem com o módulo Phalcon embutido. Os usuários precisam ativar e reiniciar o PHP. Veja o artigo Como habilitar o módulo Phalcon embutido no ServBay para isso.

Diferentes Versões do Phalcon e DevTools

De acordo com as diferentes versões do PHP, é necessário instalar diferentes versões das Ferramentas de Desenvolvimento do Phalcon:

PHP 5.6, 7.0, 7.1: Phalcon 3.4.5
- Versão correspondente das Ferramentas de Desenvolvimento do Phalcon: 3.4.x
PHP 7.2, 7.3, 7.4: Phalcon 4.1.2
- Versão correspondente das Ferramentas de Desenvolvimento do Phalcon: 4.3.x
PHP 8.0, 8.1, 8.2, 8.3, 8.4: Phalcon 5.7.0
- Versão correspondente das Ferramentas de Desenvolvimento do Phalcon: 5.0.x (visto que as ferramentas de desenvolvimento oficiais não suportam bem o PHP 8.x, recomenda-se usar a versão corrigida)

Criando o Projeto Phalcon

TIP

O ServBay recomenda que os desenvolvedores coloquem seus sites no diretório /Applications/ServBay/www para facilitar o gerenciamento.

Instalando o Composer
O ServBay já vem com o Composer embutido, não sendo necessária uma instalação separada.

Criando o Diretório do Projeto

Crie o diretório do projeto e entre nele:

bash

cd /Applications/ServBay/www
mkdir servbay-phalcon-app
cd servbay-phalcon-app

Instalando as Ferramentas de Desenvolvimento do Phalcon
Instale as ferramentas de desenvolvimento correspondentes à versão do PHP:
- PHP 5.6, 7.0, 7.1:
  bash
```
composer require phalcon/devtools:"^3.4"
```
  1
- PHP 7.2, 7.3, 7.4:
  bash
```
composer require phalcon/devtools:"~4.1"
```
  1
- PHP 8.0, 8.1, 8.2, 8.3, 8.4:
Crie o arquivocomposer.json com o seguinte conteúdo

json

{
 "repositories": [
    {
       "url": "https://github.com/daleffe/phalcon-devtools-5.x-fixed.git",
       "type": "git"
    }
 ],
 "require": {
    "phalcon/devtools": "dev-master"
 },
 "minimum-stability": "dev",
 "prefer-stable": true
}

Em seguida, execute:

bash

composer update

Criando o Projeto Phalcon
Use as ferramentas de desenvolvimento do Phalcon para criar um novo projeto:
bash
```
vendor/bin/phalcon project servbay-phalcon-app
```
1
Entrando no Diretório do Projeto
Entre no diretório do novo projeto Phalcon criado:
bash
```
cd servbay-phalcon-app
```
1

Configuração Inicial

Configurar Variáveis de Ambiente

No arquivo app/config/config.php, configure as informações de conexão do banco de dados e outras variáveis de ambiente, certificando-se de que as configurações estão corretas:

php

return new \Phalcon\Config([
    'database' => [
        'adapter' => 'Mysql',
        'host' => '127.0.0.1',
        'username' => 'root',
        'password' => 'password',
        'dbname' => 'servbay_phalcon_app',
    ],
]);

Configuração do Servidor Web

Utilize a função 'Hospedagem' do ServBay para acessar o projeto Phalcon através do servidor Web. Nas configurações de 'Hospedagem' do ServBay, adicione uma nova hospedagem:

Nome: My First Phalcon Dev Site
Domínio: servbay-phalcon-test.local
Tipo de Site: PHP
Versão do PHP: escolha a versão correspondente do PHP
Diretório Raiz do Site: /Applications/ServBay/www/servbay-phalcon-app/servbay-phalcon-app/public

Para passos detalhados de configuração, consulte Adicionando o Primeiro Site.

Adicionando Código de Exemplo

No arquivo app/config/routes.php, adicione o seguinte código para exibir "Hello ServBay!":

php

$router->add(
    '/',
    [
        'controller' => 'index',
        'action'     => 'index',
    ]
);

No arquivo app/controllers/IndexController.php, adicione o seguinte código:

php

namespace App\Controllers;

use Phalcon\Mvc\Controller;

class IndexController extends Controller
{
    public function indexAction()
    {
        echo 'Hello ServBay!';
    }
}

Acessando o Site

Abra o navegador e acesse https://servbay-phalcon-test.local, você verá a página exibindo Hello ServBay!.

Exemplo de Banco de Dados NoSQL

Exemplo de Memcached

Instalar a Extensão Memcached
No ServBay, a extensão Memcached já vem pré-instalada, não sendo necessária instalação adicional.

Configurar o Memcached

No arquivo app/config/config.php, adicione as informações de conexão do Memcached:

php

return new \Phalcon\Config([
    'database' => [
        'adapter' => 'Mysql',
        'host' => '127.0.0.1',
        'username' => 'root',
        'password' => 'password',
        'dbname' => 'servbay_phalcon_app',
    ],
    'cache' => [
        'adapter' => 'Memcached',
        'host' => '127.0.0.1',
        'port' => 11211,
    ],
]);

Configurar Rotas

No arquivo app/config/routes.php, adicione o seguinte código:

php

$router->add(
    '/memcached',
    [
        'controller' => 'index',
        'action'     => 'memcached',
    ]
);

Utilizando o Memcached

No controlador, utilize o cache:

php

namespace App\Controllers;

use Phalcon\Mvc\Controller;
use Phalcon\Cache\Backend\Memcached;
use Phalcon\Cache\Frontend\Data as FrontData;

class IndexController extends Controller
{
    public function memcachedAction()
    {
        $frontCache = new FrontData([
            'lifetime' => 86400
        ]);

        $cache = new Memcached($frontCache, [
            'host' => '127.0.0.1',
            'port' => 11211,
        ]);

        $cacheKey = 'my_cache_key';
        $cachedData = $cache->get($cacheKey);

        if ($cachedData === null) {
            $cachedData = 'Hello Memcached!';
            $cache->save($cacheKey, $cachedData);
        }

        echo $cachedData;
    }
}

Abra o navegador e acesse https://servbay-phalcon-test.local/memcached

Exemplo de Redis

Instalar a Extensão Redis
No ServBay, a extensão Redis já vem pré-instalada, não sendo necessária instalação adicional.

Configurar o Redis

No arquivo app/config/config.php, adicione as informações de conexão do Redis:

php

return new \Phalcon\Config([
    'database' => [
        'adapter' => 'Mysql',
        'host' => '127.0.0.1',
        'username' => 'root',
        'password' => 'password',
        'dbname' => 'servbay_phalcon_app',
    ],
    'cache' => [
        'adapter' => 'Redis',
        'host' => '127.0.0.1',
        'port' => 6379,
    ],
]);

Configurar Rotas

No arquivo app/config/routes.php, adicione o seguinte código:

php

$router->add(
    '/redis',
    [
        'controller' => 'index',
        'action'     => 'redis',
    ]
);

Utilizando o Redis

No controlador, utilize o cache:

php

namespace App\Controllers;

use Phalcon\Mvc\Controller;
use Phalcon\Cache\Backend\Redis;
use Phalcon\Cache\Frontend\Data as FrontData;

class IndexController extends Controller
{
    public function redisAction()
    {
        $frontCache = new FrontData([
            'lifetime' => 86400
        ]);

        $cache = new Redis($frontCache, [
            'host' => '127.0.0.1',
            'port' => 6379,
        ]);

        $cacheKey = 'my_cache_key';
        $cachedData = $cache->get($cacheKey);

        if ($cachedData === null) {
            $cachedData = 'Hello Redis!';
            $cache->save($cacheKey, $cachedData);
        }

        echo $cachedData;
    }
}

Abra o navegador e acesse https://servbay-phalcon-test.local/redis

Exemplo de Banco de Dados Relacional

Criar Estrutura do Banco de Dados e Arquivos de Migração

Criando Arquivo de Migração
Utilize as ferramentas de desenvolvimento do Phalcon para criar o arquivo de migração:
bash
```
vendor/bin/phalcon migration generate --directory=servbay-phalcon-app
```
1

Editando o Arquivo de Migração

No diretório migrations, crie um novo arquivo de migração e edite-o para definir a estrutura da tabela do banco de dados:

php

use Phalcon\Db\Column;
use Phalcon\Db\Index;
use Phalcon\Migrations\Mvc\Model\Migration;

class UsersMigration_100 extends Migration
{
    public function morph()
    {
        $this->morphTable('users', [
            'columns' => [
                new Column(
                    'id',
                    [
                        'type'          => Column::TYPE_INTEGER,
                        'autoIncrement' => true,
                        'notNull'       => true,
                        'primary'       => true,
                    ]
                ),
                new Column(
                    'name',
                    [
                        'type'    => Column::TYPE_VARCHAR,
                        'size'    => 255,
                        'notNull' => true,
                    ]
                ),
                new Column(
                    'email',
                    [
                        'type'    => Column::TYPE_VARCHAR,
                        'size'    => 255,
                        'notNull' => true,
                        'unique'  => true,
                    ]
                ),
            ],
            'indexes' => [
                new Index('PRIMARY', ['id'], 'PRIMARY'),
                new Index('email_UNIQUE', ['email'], 'UNIQUE'),
            ],
        ]);
    }
}

Executando a Migração
Utilize o comando da ferramenta de desenvolvimento do Phalcon para executar a migração e criar a tabela:
bash
```
vendor/bin/phalcon migration run --directory=servbay-phalcon-app
```
1

Exemplo de MySQL

Configurar o MySQL

No arquivo app/config/config.php, configure as informações de conexão do MySQL:

php

return new \Phalcon\Config([
    'database' => [
        'adapter' => 'Mysql',
        'host' => '127.0.0.1',
        'username' => 'root',
        'password' => 'password',
        'dbname' => 'servbay_phalcon_app',
    ],
]);

Configurar Rotas

No arquivo app/config/routes.php, adicione o seguinte código:

php

$router->add(
    '/mysql-add',
    [
        'controller' => 'index',
        'action'     => 'mysqlAdd',
    ]
);

$router->add(
    '/mysql',
    [
        'controller' => 'index',
        'action'     => 'mysql',
    ]
);

Inserindo Dados dos Usuários

No controlador, insira os dados dos usuários:

php

namespace App\Controllers;

use Phalcon\Mvc\Controller;
use Phalcon\Db\Adapter\Pdo\Mysql;

class IndexController extends Controller
{
    public function mysqlAddAction()
    {
        $connection = new Mysql([
            'host'     => '127.0.0.1',
            'username' => 'root',
            'password' => 'password',
            'dbname'   => 'servbay_phalcon_app',
        ]);

        $success = $connection->insert(
            'users',
            ['ServBay', '[email protected]'],
            ['name', 'email']
        );

        echo $success ? 'User added' : 'Failed to add user';
    }

    public function mysqlAction()
    {
        $connection = new Mysql([
            'host'     => '127.0.0.1',
            'username' => 'root',
            'password' => 'password',
            'dbname'   => 'servbay_phalcon_app',
        ]);

        $users = $connection->fetchAll('SELECT * FROM users', \Phalcon\Db\Enum::FETCH_ASSOC);

        echo json_encode($users);
    }
}

Abra o navegador e acesse https://servbay-phalcon-test.local/mysql-add e https://servbay-phalcon-test.local/mysql

Exemplo de PostgreSQL

Configurar o PostgreSQL

No arquivo app/config/config.php, configure as informações de conexão do PostgreSQL:

php

return new \Phalcon\Config([
    'database' => [
        'adapter' => 'Postgresql',
        'host' => '127.0.0.1',
        'username' => 'root',
        'password' => 'password',
        'dbname' => 'servbay_phalcon_app',
    ],
]);

Configurar Rotas

No arquivo app/config/routes.php, adicione o seguinte código:

php

$router->add(
    '/pgsql-add',
    [
        'controller' => 'index',
        'action'     => 'pgsqlAdd',
    ]
);

$router->add(
    '/pgsql',
    [
        'controller' => 'index',
        'action'     => 'pgsql',
    ]
);

Inserindo Dados dos Usuários

No controlador, insira os dados dos usuários:

php

namespace App\Controllers;

use Phalcon\Mvc\Controller;
use Phalcon\Db\Adapter\Pdo\Postgresql;

class IndexController extends Controller
{
    public function pgsqlAddAction()
    {
        $connection = new Postgresql([
            'host'     => '127.0.0.1',
            'username' => 'root',
            'password' => 'password',
            'dbname'   => 'servbay_phalcon_app',
        ]);

        $success = $connection->insert(
            'users',
            ['ServBay', '

Criando e Executando um Projeto Phalcon ​

O que é Phalcon? ​

Principais características e vantagens do Phalcon ​

Criando e Executando um Projeto Phalcon com o ServBay ​

Diferentes Versões do Phalcon e DevTools ​

Criando o Projeto Phalcon ​

Configuração Inicial ​

Configuração do Servidor Web ​

Adicionando Código de Exemplo ​

Acessando o Site ​

Exemplo de Banco de Dados NoSQL ​

Exemplo de Memcached ​

Exemplo de Redis ​

Exemplo de Banco de Dados Relacional ​

Criar Estrutura do Banco de Dados e Arquivos de Migração ​

Exemplo de MySQL ​

Exemplo de PostgreSQL ​

Criando e Executando um Projeto Phalcon

O que é Phalcon?

Principais características e vantagens do Phalcon

Criando e Executando um Projeto Phalcon com o ServBay

Diferentes Versões do Phalcon e DevTools

Criando o Projeto Phalcon

Configuração Inicial

Configuração do Servidor Web

Adicionando Código de Exemplo

Acessando o Site

Exemplo de Banco de Dados NoSQL

Exemplo de Memcached

Exemplo de Redis

Exemplo de Banco de Dados Relacional

Criar Estrutura do Banco de Dados e Arquivos de Migração

Exemplo de MySQL

Exemplo de PostgreSQL