BeSimpleSoap/README.markdown

58 lines
1.8 KiB
Markdown
Raw Normal View History

2010-10-03 17:26:14 +02:00
WebServiceBundle
================
The WebServiceBundle is a Symfony2 bundle to build WSDL and SOAP based web services.
It is based on the [ckWebServicePlugin] [1] for symfony.
2011-04-08 01:19:57 +02:00
Requirements
2010-10-08 17:42:42 +02:00
------------
2011-04-08 01:19:57 +02:00
* Install and enable PHP's `SOAP` extension
* Download and add `Zend\Soap` library to `app/autoload.php`
QuickStart
----------
* Put WebServiceBundle in your `src/Bundle` dir
* Enable WebServiceBundle in your `app/AppKernel.php`
* Include the WebServiceBundle's routing configuration in `app/config/routing.yml` (you can choose the prefix arbitrarily)
_ws:
resource: "@WebServiceBundle/Resources/config/routing/webservicecontroller.xml"
prefix: /ws
* Configure your first web service in `app/config/config.yml`
web_service:
services:
demoapi:
name: DemoApi
namespace: http://mysymfonyapp.com/ws/DemoApi/1.0/
binding: rpc-literal
resource: "@AcmeDemoBundle/Controller/DemoController.php"
resource_type: annotation
* Annotate your controller methods
// src/Acme/DemoBundle/Controller/DemoController.php
/**
* @ws:Method('hello')
* @ws:Param('name', type = 'string')
*/
public function helloAction($name)
{
return new SoapResponse(sprintf('Hello %s!', $name));
}
* Open your web service endpoint
* `http://localhost/app_dev.php/ws/DemoApi` - HTML documentation
* `http://localhost/app_dev.php/ws/DemoApi?WSDL` - WSDL file
2010-10-08 17:42:42 +02:00
Test
----
phpunit -c myapp src/Bundle/WebServiceBundle
2010-10-03 17:26:14 +02:00
[1]: http://www.symfony-project.org/plugins/ckWebServicePlugin