A funcionalidade básica do Apache mod_rewrite
pode ser simulada por um script PHP referenciado no app.yaml
que, por sua vez, carregará o script desejado. Esse exemplo simula o padrão PHP comum que espera que a variável $_GET['q']
contenha o caminho da solicitação.
Sobre mod_rewrite.php
Para ativar a funcionalidade mod_rewrite, seu aplicativo precisa incluir
mod_rewrite.php
, que é o script que será invocado para todas as solicitações para que seu
aplicativo execute o roteamento da solicitação. Conforme descrito nos comentários, o script vai verificar
a existência de scripts PHP no nível raiz e os invocará ao colocar a parte do caminho de
$_SERVER['REQUEST_URI']
na variável $_GET['q']
.
<?php /** * @file * Provide basic mod_rewrite like functionality. * * Pass through requests for root php files and forward all other requests to * index.php with $_GET['q'] equal to path. The following are examples that * demonstrate how a request using mod_rewrite.php will appear to a PHP script. * * - /install.php: install.php * - /update.php?op=info: update.php?op=info * - /foo/bar: index.php?q=/foo/bar * - /: index.php?q=/ */ $path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH); // Provide mod_rewrite like functionality. If a php file in the root directory // is explicitly requested then load the file, otherwise load index.php and // set get variable 'q' to $_SERVER['REQUEST_URI']. if (dirname($path) == '/' && pathinfo($path, PATHINFO_EXTENSION) == 'php') { $file = pathinfo($path, PATHINFO_BASENAME); } else { $file = 'index.php'; // Provide mod_rewrite like functionality by using the path which excludes // any other part of the request query (ie. ignores ?foo=bar). $_GET['q'] = $path; } // Override the script name to simulate the behavior without mod_rewrite.php. // Ensure that $_SERVER['SCRIPT_NAME'] always begins with a / to be consistent // with HTTP request and the value that is normally provided. $_SERVER['SCRIPT_NAME'] = '/' . $file; require $file;
Exemplo de aplicativo
Veja a seguir um aplicativo muito simples feito para receber $_GET['q']
.
app.yaml
Como é possível ver neste arquivo app.yaml
, o aplicativo fornecerá dois scripts PHP de
nível raiz e exibirá arquivos estáticos fora de um diretório chamado downloads
.
application: mod_rewrite_simulator version: 1 runtime: php55 api_version: 1 handlers: # Example of handler which should be placed above the catch-all handler. - url: /downloads static_dir: downloads # Catch all unhandled requests and pass to mod_rewrite.php which will simulate # mod_rewrite by forwarding the requests to index.php?q=... (or other root-level # PHP file if specified in incoming URL. - url: /.* script: mod_rewrite.php
index.php
index.php
é um estilo de roteador index.php
que lê
$_GET['q']
para determinar o caminho da solicitação.
<?php if ($_GET['q'] == '/help') { echo 'This is some help text.'; exit; } echo 'Welcome to the site!';
other.php
Veja a seguir um exemplo de script de nível de raiz que pode ser chamado diretamente. Muitos frameworks PHP têm scripts como install.php
ou update.php
que têm um
comportamento parecido.
<?php echo 'Welcome to the other site.';
Exemplos de solicitação
Com o aplicativo de exemplo acima, as solicitações a seguir seriam gerenciadas conforme mostrado.
/
é traduzido paraindex.php
com$_GET['q'] = '/'
/help
é traduzido paraindex.php
com$_GET['q'] = '/help'
/other.php
é traduzido paraother.php
com$_GET['q'] = null
/downloads/foo_17.png
é traduzido paradownloads/foo_17.png
Evite depender de mod_rewrite.php
Muitos frameworks PHP não dependem mais de $_GET['q']
. Em vez disso, eles usam $_SERVER['REQUEST_URI']
, que funciona com e sem mod_rewrite
.
Este é o método preferido no App Engine.
Conforme usado em mod_rewrite.php
, veja um método simples de
usar REQUEST_URI
:
<?php $path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH); if ($path == '/help') { echo 'This is some help text.'; exit; } echo 'Welcome to the site!';