Explicando o que foi feito:

Este é um exemplo bem simples e útil da utilização do Cajax.

Primeiro, requisita-se a classe de Interface. Esta classe implementa os métodos básicos (de javascript e PHP) para a manipulação de eventos XMLHttpRequest, além de incluir as classes de todos os "Handlers" disponíveis.

Após o require, instanciamos a classe CajaxInterface.

Por padrão, a classe tenta usar como cache o diretório cajaxJS a partir do script sendo executado. Assim, se você está executando a página /var/www/meusite/index.php, Cajax tentará utilizar o diretório /var/www/meusite/cajaxJS como diretório de cache. Para alterar este mecanismo, dois métodos são utilizados:

$Cajax->setCacheDir('diretorio'): este método definirá a pasta de arquivos de cache. Este diretório deve ser relativo ao DOCUMENT_ROOT e o webserver deve possuir permissão de escrita nele.
$Cajax->useCache( false ): Define se Cajax usará ou não cache. Tenha em mente que desabilitar o cache pode acarretar perda significativa de desempenho, já que toda saída javascript gerada pela classe será gerada a cada requisição e enviada ao browser junto do resto da página, aumentando o processamento do PHP e impossibilitando o navegador de usar seus caches de arquivos já baixados.

Após a definição da "política" de cache, o Handler para manipulação de formulário é criado.

Este handler em especial recebe como parâmetros o ID do formulário a ser observado e uma função javascript que recebe a string retornada pelo servidor. Esta função pode ser definida diretamente na passagem do parâmetro à classe CajaxFormHandler ou ao longo do script. Se a segunda opção fosse a escolhida, a página teria uma função javascript definida com um nome qualquer e, na instanciação do objeto CajaxFormHandler, o nome desta função seria passado. Por exemplo:


Para funcionar, todo handler deve ser adicionado à interface Cajax com o método $Cajax->addHandler.

Quando todos os handlers estiverem definidos e adicionados à interface, o método $Cajax->handleAll() deve ser executado para processar possíveis necessidades dos handlers.

Pronto. Agora, só resta mostrar o Javascript no header da página:

A explicação é longa, mas o script foi simples, não foi? Agora, toda vez que ocorrer um submit no formulário formID, a requisição será enviada através de XMLHttpRequest ao servidor e a resposta será colocada, através do javascript (document.getElementById("respostaDiv").innerHTML = resposta;), dentro da div que possui o ID "respostaDiv". Simples! :D