Flash Remoting com AMFPHP - Primeiro passo

Este Documento

Este documento dá uma introdução ao uso de Flash Remoting usando o AMFPHP (http://www.amfphp.org).

Flash Remoting e AMFPHP

Flash Remoting para PHP possibilita basicamente passar objetos do PHP para o Flash por meio de SOAP. AMFPHP cuida de todas aas conversões de tipos, serialização e outros detalhes de client-server. Esse esquema deixa ambos códigos ActionScript e PHP mais limpos ao contrário do uso comum do esquema de troca de XML puro, permitindo uso de XML-RPC dentro do Flash.

Funcionamento

Uma aplicação Flash que use AMFPHP precisa, no lado cliente (Flash):

1) Incluir as bibliotecas para uso de Flash Remoting.
2) Definir o gateway padrão dos flashservices.
3) Criar uma conexão com o gateway.
4) Criar o objeto de resposta da chamada remota.
5) Definir o handler onResult, que será chamado como resposta do service.
6) Instanciar o service.
7) Fazer a chamada ao service.

e no lado server (PHP):

1) Criar um gateway padrão definindo o diretório onde deverão ficar os services.
2) Nesse diretório criar um arquivo para o service, definindo a classe do service.

Exemplo

Um aplicativo Flash que envia uma mensagem de e-mail usando AMFPHP.

1) Instalando a biblioteca AMFPHP:
Basta copiar o conteudo da pasta flashservices da distribuição do AMFPHP dentro de um diretório no servidor. Por exemplo:

/home/eldes/lib/amfphp

2) Criar um gateway padrão em um diretório acessível via web; e criar um diretório onde serão colocados os services. Por exemplo:

/home/eldes/public_html/flashservices/gateway.php
/home/eldes/public_html/flashservices/services/

O código do gateway seria algo como:

setBaseClassPath("./services/"); $gateway->service(); ?>

3) Criar um filme Flash contendo um campo texto para digitar uma mensagem (_root.my_message), um botão de envio (_root.my_send_button) e um campo texto para mostrar o resultado do envio (_root.my_result).

4) Codificar o actionscript:

//1) Incluir as bibliotecas para uso de Flash Remoting. #include "NetServices.as" #include "NetDebug.as" _global.Message = function() { } _global.Message.prototype.text = "none"; _global.Message.prototype.to = "none"; _global.Message.prototype.subject = "none"; //2) Definir o gateway padrão dos flashservices. NetServices.setDefaultGateway("http://localhost/~eldes/flashservices/gateway.php"); //3) Criar uma conexão com o gateway. conn = NetServices.createGatewayConnection(); //6) Instanciar o service. sendmail = conn.getService("Sendmail"); //7) Fazer a chamada ao service. _root.my_send_button.onPress = function(){ var message = new Message(); message.text = _root.my_message.text; message.to = "seu.email@dominio.com"; message.subject = "[amfphp-teste]"; sendmail.sendMessage(sendMessageRequest, message); } //4) Criar o objeto de resposta da chamada remota. sendMessageRequest = new Object(); //5) Definir o handler onResult, que será chamado como resposta do service. sendMessageRequest.onResult = function(result_from_php) { _root.my_result.text = result_from_php; } stop();

5) Codificar o service (/home/eldes/public_html/flashservices/services/Sendmail.php):

text = $message_from_as['text']; $this->to = $message_from_as['to']; $this->subject = $message_from_as['subject']; } } class Sendmail { function Sendmail() { $this->methodTable = array( "sendMessage" => array( "description" => "Send a e-mail message.", "access" => "remote", "arguments" => array ("arg1") ) ); } function sendMessage($message_from_as) { $message = new Message($message_from_as); return mail($message->to, $message->subject, $message->text) ? "ow yeah!" : "oops!"; } } ?>