Functions / Helpers

O que é?

Antes de criarmos nosso primeiro model, controller e integrar com uma view, precisamos falar sobre as functions ou helpers do Harpia.

Não se preocupe senão entender o porque de alguma função, algumas funções foram criadas para utilizar em conjunto com o controller (por exemplo), mais à frente isso ficará mais claro.

view($path)

Retorna uma view.
Path: caminho do arquivo (aponta para a pasta view), ex: view('/painel/index') -> retorna o arquivo index dentro da pasta painel que está dentro da pasta view (/app_old/view/painel/index.php)

get($value)

Retorna um valor que foi passado para a View.

getOr($value, $alternativeValue)

Retorna um valor que foi passado para a View. Caso esse valor não exista, será retornado o valor alternativo. Um bom exemplo de quando utilizar: Bem-vindo, <?= getOr('username', 'Visitante') ?>!

response($message, $code = 200, $options = [])

Use esta função para retornar respostas HTTP.
Em message, você pode passar um número, string ou array (param 1). O código padrão será 200 (param 2) e nas options você pode passar as configurações da sua resposta, como por exemplo:

$options = ['Access-Control-Allow-Origin' => '*']

$options['Access-Control-Allow-Methods'] = 'GET, POST, OPTIONS'

getConnection($charset = config -> DB_CHARSET)

Retorna a conexão (PDO) com o banco de dados. O valor padrão do primeiro paramêtro será o valor da que estiver na constante DB_CHARSET em /app_old/config.php.

executeQuery($query)

Executa uma query e retorna uma instância da classe MySQLResponse como resposta. Valores da instância MySQLResponse: 

      
'query' => ...,
'errorCode' => ...,
'error' => ...,
'fetch' => ...,
'executed' => ...

executed(MySQLResponse $instance)

Retorna true se a query foi executada com sucesso ou false.

parseJSON($variable)

Retorna um JSON ou caso não de para fazer o parse, retorna undefined.

asset($path) e storage($path)

Duas funções que você vai utilizar bastante!
asset() aponta para /public/assets/
storage() aponta para /public/storage/

Use para incluir arquivos js, css e imagens em sua página (ou o que precisar).

redirect($path, $data = null)

Redireciona para outra rota/local. Você pode usar @ para pegar o caminho a partir da pasta public/. 

      
redirect('@/home')
redirect('/painel/user/add')

No segundo parâmetro você pode passar valores para a view em seu redirect.

debug($var, $identifier = null)

Printa uma variável identada.

Próximo