ea003a1224 | ||
---|---|---|
Controller | ||
Converter | ||
DependencyInjection | ||
Resources | ||
ServiceBinding | ||
ServiceDefinition | ||
Soap | ||
Tests | ||
Util | ||
.gitignore | ||
BeSimpleSoapBundle.php | ||
CONTRIBUTORS.markdown | ||
README.markdown | ||
WebServiceContext.php | ||
phpunit.xml.dist | ||
vendors.php |
README.markdown
BeSimpleSoapBundle
The BeSimpleSoapBundle is a Symfony2 bundle to build WSDL and SOAP based web services. It is based on the [ckWebServicePlugin] 1 for symfony.
Requirements
-
Install and enable PHP's
SOAP
extension -
Download
Zend\Soap
git submodule add http://github.com/zendframework/zf2.git vendor/zend-framework
-
Add
Zend\Soap
library toapp/autoload.php
// app/autoload.php $loader->registerNamespaces(array( 'Zend\\Soap' => __DIR__.'/../vendor/zend-frameword/library', // your other namespaces ));
QuickStart
-
Put BeSimpleSoapBundle in your
vendor/bundles/BeSimple
dirgit submodule add https://github.com/BeSimple/BeSimpleSoapBundle.git vendor/bundles/BeSimple/SoapBundle
-
Enable BeSimpleSoapBundle in your
app/AppKernel.php
// app/AppKernel.php public function registerBundles() { return array( // ... new new BeSimple\SoapBundle\BeSimpleSoapBundle(), // ... ); }
-
Register the BeSimple namespace
// app/autoload.php $loader->registerNamespaces(array( 'BeSimple' => __DIR__.'/../vendor/bundles', 'Zend\\Soap' => __DIR__.'/../vendor/zend-frameword/library', // your other namespaces ));
-
Include the BeSimpleSoapBundle's routing configuration in
app/config/routing.yml
(you can choose the prefix arbitrarily)_besimple_soap: resource: "@BeSimpleSoapBundle/Resources/config/routing/webservicecontroller.xml" prefix: /ws
-
Configure your first web service in
app/config/config.yml
be_simple_soap: services: 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 use BeSimple\SoapBundle\ServiceDefinition\Annotation as Soap; use BeSimple\SoapBundle\Soap\SoapResponse; class DemoController extends Controller { /** * @Soap\Method("Hello") * @Soap\Param("name", phpType = "string") * @Soap\Result(phpType = "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 documentationhttp://localhost/app_dev.php/ws/DemoApi?wsdl
- WSDL file
Test
phpunit -c phpunit.xml.dist