From 724bea7eee68b5465c38c89fa54854a16cbeffd1 Mon Sep 17 00:00:00 2001 From: Alex Date: Mon, 21 Dec 2015 21:01:34 +0300 Subject: [PATCH] removed documentation , as better to prepare a reference list with links to pluguns/ modiles included, moreover it's a part of Lime docs and workarounds --- .../admin/classes/phpCAS/docs/Building | 34 - .../admin/classes/phpCAS/docs/ChangeLog | 565 --- .../admin/classes/phpCAS/docs/Upgrading | 100 - .../phpCAS/docs/examples/config.example.php | 104 - .../examples/create_pgt_storage_db_table.php | 53 - .../classes/phpCAS/docs/examples/example.css | 10 - .../docs/examples/example_advanced_saml11.php | 82 - .../docs/examples/example_custom_urls.php | 70 - .../phpCAS/docs/examples/example_gateway.php | 71 - .../docs/examples/example_hardening.php | 85 - .../phpCAS/docs/examples/example_html.php | 76 - .../phpCAS/docs/examples/example_lang.php | 63 - .../phpCAS/docs/examples/example_logout.php | 64 - .../examples/example_no_ssl_cn_validation.php | 68 - .../docs/examples/example_pgt_storage_db.php | 74 - .../examples/example_pgt_storage_file.php | 74 - .../docs/examples/example_proxy_GET.php | 98 - .../docs/examples/example_proxy_POST.php | 103 - .../examples/example_proxy_rebroadcast.php | 63 - .../examples/example_proxy_serviceWeb.php | 71 - .../example_proxy_serviceWeb_chaining.php | 71 - .../phpCAS/docs/examples/example_renew.php | 72 - .../phpCAS/docs/examples/example_service.php | 96 - .../docs/examples/example_service_POST.php | 105 - .../examples/example_service_that_proxies.php | 106 - .../phpCAS/docs/examples/example_simple.php | 63 - .../phpCAS/docs/examples/script_info.php | 20 - .../phpCAS/docs/images/esup-portail.png | Bin 2621 -> 0 bytes .../classes/phpCAS/docs/images/jasig.png | Bin 2384 -> 0 bytes .../classes/phpCAS/docs/images/phpcas.png | Bin 6771 -> 0 bytes .../admin/classes/phpCAS/docs/index.html | 19 - .../admin/classes/xmlrpc/doc/Makefile | 80 - .../admin/classes/xmlrpc/doc/apa.html | 8 - .../admin/classes/xmlrpc/doc/apb.html | 12 - .../admin/classes/xmlrpc/doc/apc.html | 5 - .../admin/classes/xmlrpc/doc/apd.html | 24 - .../admin/classes/xmlrpc/doc/ch01.html | 10 - .../admin/classes/xmlrpc/doc/ch02.html | 35 - .../admin/classes/xmlrpc/doc/ch02s02.html | 16 - .../admin/classes/xmlrpc/doc/ch02s03.html | 9 - .../admin/classes/xmlrpc/doc/ch02s04.html | 12 - .../admin/classes/xmlrpc/doc/ch02s05.html | 49 - .../admin/classes/xmlrpc/doc/ch02s06.html | 11 - .../admin/classes/xmlrpc/doc/ch02s07.html | 14 - .../admin/classes/xmlrpc/doc/ch02s08.html | 13 - .../admin/classes/xmlrpc/doc/ch02s09.html | 78 - .../admin/classes/xmlrpc/doc/ch03.html | 13 - .../admin/classes/xmlrpc/doc/ch04.html | 31 - .../admin/classes/xmlrpc/doc/ch05.html | 21 - .../admin/classes/xmlrpc/doc/ch06.html | 15 - .../admin/classes/xmlrpc/doc/ch06s02.html | 11 - .../admin/classes/xmlrpc/doc/ch07.html | 109 - .../admin/classes/xmlrpc/doc/ch07s02.html | 35 - .../admin/classes/xmlrpc/doc/ch07s03.html | 195 - .../admin/classes/xmlrpc/doc/ch07s04.html | 33 - .../admin/classes/xmlrpc/doc/ch07s05.html | 202 - .../admin/classes/xmlrpc/doc/ch08.html | 21 - .../admin/classes/xmlrpc/doc/ch08s02.html | 45 - .../admin/classes/xmlrpc/doc/ch09.html | 28 - .../admin/classes/xmlrpc/doc/ch09s02.html | 71 - .../admin/classes/xmlrpc/doc/ch09s03.html | 103 - .../admin/classes/xmlrpc/doc/ch09s04.html | 14 - .../admin/classes/xmlrpc/doc/ch09s05.html | 8 - .../admin/classes/xmlrpc/doc/ch10.html | 12 - .../admin/classes/xmlrpc/doc/ch10s02.html | 6 - .../admin/classes/xmlrpc/doc/ch10s03.html | 19 - .../admin/classes/xmlrpc/doc/ch10s04.html | 6 - .../admin/classes/xmlrpc/doc/ch10s05.html | 10 - .../admin/classes/xmlrpc/doc/ch11.html | 8 - .../admin/classes/xmlrpc/doc/ch11s02.html | 3 - .../admin/classes/xmlrpc/doc/ch12.html | 20 - .../admin/classes/xmlrpc/doc/ch12s02.html | 18 - .../admin/classes/xmlrpc/doc/ch12s03.html | 6 - .../admin/classes/xmlrpc/doc/ch12s04.html | 5 - .../admin/classes/xmlrpc/doc/ch12s05.html | 13 - .../admin/classes/xmlrpc/doc/ch12s06.html | 27 - .../admin/classes/xmlrpc/doc/ch12s07.html | 22 - .../admin/classes/xmlrpc/doc/ch12s08.html | 13 - .../admin/classes/xmlrpc/doc/index.html | 32 - .../admin/classes/xmlrpc/doc/xmlrpc_php.pdf | Bin 270346 -> 0 bytes .../admin/classes/xmlrpc/doc/xmlrpc_php.xml | 4254 ----------------- 81 files changed, 8285 deletions(-) delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/Building delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/ChangeLog delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/Upgrading delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/config.example.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/create_pgt_storage_db_table.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example.css delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_advanced_saml11.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_custom_urls.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_gateway.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_hardening.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_html.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_lang.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_logout.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_no_ssl_cn_validation.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_pgt_storage_db.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_pgt_storage_file.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_GET.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_POST.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_rebroadcast.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_serviceWeb.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_serviceWeb_chaining.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_renew.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_service.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_service_POST.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_service_that_proxies.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/example_simple.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/examples/script_info.php delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/images/esup-portail.png delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/images/jasig.png delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/images/phpcas.png delete mode 100644 include/limesurvey/admin/classes/phpCAS/docs/index.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/Makefile delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/apa.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/apb.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/apc.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/apd.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch01.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch02.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch02s02.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch02s03.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch02s04.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch02s05.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch02s06.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch02s07.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch02s08.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch02s09.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch03.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch04.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch05.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch06.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch06s02.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch07.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch07s02.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch07s03.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch07s04.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch07s05.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch08.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch08s02.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch09.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch09s02.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch09s03.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch09s04.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch09s05.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch10.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch10s02.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch10s03.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch10s04.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch10s05.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch11.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch11s02.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch12.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch12s02.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch12s03.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch12s04.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch12s05.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch12s06.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch12s07.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/ch12s08.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/index.html delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/xmlrpc_php.pdf delete mode 100644 include/limesurvey/admin/classes/xmlrpc/doc/xmlrpc_php.xml diff --git a/include/limesurvey/admin/classes/phpCAS/docs/Building b/include/limesurvey/admin/classes/phpCAS/docs/Building deleted file mode 100644 index 1b4a5c32..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/Building +++ /dev/null @@ -1,34 +0,0 @@ -######################################## -### Build process for phpCAS package ### -######################################## - -1. Prepare your own build config: - -go to the utils/ dir and copy build-example.properties to a -build.properties file and adjust the path for all needed binaries. You need -at least php and doxygen for package creation. Git is needed as a developer with -commit priviledges and upload right for the distribution package. - -2. Install necessary php packages: - -Install the pear package PEAR_PackageFileManager2 via the command - -"pear install PEAR_PackageFileManager2" - - -3. Run the "ant" tasks to build the phpCAS package and other developer tasks: - -ant dist # create a local package -ant clean # clear local packages and temporary files -ant prepare # The default action, tags, packages, and commits to the local git repository -ant push # Push the new commits and tags to the origin repository (github) -ant upload # Upload to jasig -ant makeCurrentSymlink # Set the symbolic link on the jasig site for the most current packages -ant revert # To revert any "ant prepare" actions before they are pushed to the github repo - -The ant prepare target is equivalent to ant tag && ant dist && ant markdev. - -To revert the commits and tag additions added in the ant tag and ant markdev -targets, use the new ant revert target. This should not be done after pushing. -Running ant prepare is safe and can be followed by ant revert to get rid of the -added commits and tag in your local repository. \ No newline at end of file diff --git a/include/limesurvey/admin/classes/phpCAS/docs/ChangeLog b/include/limesurvey/admin/classes/phpCAS/docs/ChangeLog deleted file mode 100644 index d8a43224..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/ChangeLog +++ /dev/null @@ -1,565 +0,0 @@ -Changes in version 1.3.4 -Security Fixes: - -Bug Fixes: - * Mark auth call completed for post-auth callback [#131] (Daniel Frett) - * Remove typo CAS_TypeMismatchException [#133] (Gabrijel Gavranović) - * Fix SERVER_ADMIN error for alternate Webservers [#103] (Joachim Fritschi) - * Fix non-strict string comparision in _isHttps check [#139] (Brandon Peters) - * Fix setNoCasServerValidation for cURL 7.10 [#122] (Joachim Fritschi) - * Fix renew support [#93] (Joachim Fritschi) - * _getClientUrl() fixes with reverse proxies [#154] adongy - * Param type doc should be 'string' in CAS::logoutWithRedirectService() [#167] Chris McCafferty - * Fix broken class reference [#161] Joachim Fritschi - - -Improvement: - * Add phpCAS::isInitialized() API method [#112] (Adam Franco) - * select temporary directory based on env vars [#136) (Geoffroy Desvernay) - * Add gitattributes to reduce unnecessary files from composer installs. [#141] (Jon Dufresne) - * Allow cas endpoint to be a 'get url' [#146] (flushbi) - * Add documentation for phpCAS::$_PHPCAS_CLIENT [#156] (Sylvain) - * Improve https check [#139] (Joachim Fritschi) - * Add time to trace [#158] (cwsterling) - * Add php5.6 tests, move to faster docker env [#169] (Florian Holzhauer) - * Introduce a setVerbose() toggle to prevent debug info leaking in production [#152 #147] (Joachim Fritschi) - - -Changes in version 1.3.3 -Security Fixes: - * CVE-2014-4172 Urlencode all tickets [#125] (Marvin Addison) - -Bug Fixes: - * Fix CURL compatibility CURL >= 7.28.0 [#66] (adoy) - * Commit session before redirect [#79] (kakawait) - * Fix warnings for php => 5.5 [87] (fh) - * Update wrong wording in examples [#90] (misilot) - * Fixed bug in imap.php [#105] (echampet) - * Fix missing Server_Admin variable for nginex [#121](arianf) - * Fix error in TypeMismatchException [#123 ](Develle) - * Fix bug in https test [#126] (Florent Baldino) - - -Improvement: - * Fix grammar of documentation [#61] (frett) - * Improved testability of the phpCAS client [#7] (Adam Franco) - * Fixed typo [#70] (fh) - * Example for improved cookie hardening [#67] (Joachim Fritschi) - * Added support for X-Forwarded-Proto Header [#77] (Paul Donohue) - * Added composer support [#73] (dhyde) - * Travis for continuous integration [#82] (fh) - * Support for X-Forwared-Port [#100] (neopeak) - * Support for CAS 3.0 protocol [#116] (fredrik-w) - - -Changes in version 1.3.2 -Security Fixes: - * CVE-2012-5583 Missing CN validation of CAS server certificate [#58] (Joachim Fritschi) - -Bug Fixes: - * Fix broken character encoding in Greek and French [#40] (Joachim Fritschi) - * Minor error corrections in a few example files [] (Joachim Fritschi) - * Remove erroneous break statement [#44] (jbittel) - * Use X-Forwarded-Port [#45] (Andrew Kirkpatrick) - * Stop autoloader using set_include_path [#51/#52] (drysdaleb) - * Fix undefined property in the rebroadcast code [#47] (Joachim Fritschi) - -Improvement: - * Enable getCookies on a proxied sevices [#56] (Adam Franco) - -Changes in version 1.3.1 -Bug Fixes: - * Readd PEAR support to the package [#30] (Joachim Fritschi) - * fix a __autoload conflicts in the autoloader [#36] (Joachim Fritschi) - * fix PEAR code style errors [25] (Joachim Fritschi) - * properly unset variables during checkAuthenticate[#35] (Joachim Fritschi) - -Changes in version 1.3.0 -Improvements: - * enable single sign-out when session has already started [#29] (Benvii) - -Changes in version 1.3.0RC1 - -Bug Fixes: - * the saml logout url should be parsed urlencoded [#24] (dlineate) - * fix a proxy mode bug introduced in a previous comitt [#16] (Adam Franco) - * Fix include_path order so that the phpCAS path takes precedence [#13] (Adam Franco) - * fix invalid characters in the php session naming [#17] (Joachim Fritschi) - * fix an initialisation problem introduced in the PGT storage [18] (Daniel Frett) - * make sure the PGTStorage object is initialized if a user is utilizing the createTable method [#4] (Daniel Frett) - * Fix error message in phpCAS::setCacheTimesForAuthRecheck() [PHPCAS-132/#1] (Bradley Froehle) - * Always return attributes in utf8 [PHPCAS-102] - * Fix warning during debugging if debug is set to false [PHPCAS-123] (Sean Watkins) - -New Features: - * Add a script to create the PGT db table in proxy mode [#11] (Joachim Fritschi) - * Switch to the Apache License [#5] (Adam Franco, Joachim Fritschi) - * Move to github and add all necessary file to package [#12] (Adam Franco) - * New build process for github [#12] (Adam Franco) - * Update unit tests to work with the lastest phpunit version [PHPCAS-128] (Adam Franco) - * Refacatoring of the protocol decision making to allow validation of proxied usage [PHPCAS-69] (Joachim Fritschi, Adam Franco) - * Rebroadcast of logout and pgtiou to support clustered phpcas [PHPCAS-100] (Matthew Selwood, Adam Franco) - -Improvements: - * Improved cookie handling [] (Adam Franco - * Indent, format and user name guidelines of PEAR [#14] (Joachim Fritschi) - * Add a class autoloading feature [PHPCAS-125/#8] (Joachim Fritschi) - * Remove global variables [PHPCAS-126] (Adam Franco) - * Implementation of an exception framework to allow gracefull termination [PHPCAS-109] (Joachim Fritschi) - -Security Fixes: - * CVE-2012-1104 validate proxied usage of a service [PHPCAS-69] (Joachim Fritschi, Adam Franco) - * CVE-2012-1105 change the default PGT save path to the session storage path and set proper permissions [#22] (Joachim Fritschi) - -Changes in version 1.2.2 - -Bug Fixes: - * Improve compatibility with php < 5.3 for E_USER_DEPRECATED [PHPCAS-116] (Hugh Eaves) - -Changes in version 1.2.2RC1 - -Bug Fixes: - * CASClient::getURL() cannot be private [PHPCAS-103] (Joachim Fritschi) - * CASClient::getServerServiceValidateURL() doesn't respect existing query strings [PHPCAS-104] (Bradley Froehle, Joachim Fritschi) - * CASClient::retrievePT() must be a public function [PHPCAS-107] (Joachim Fritschi) - * Expose setNoClearTicketsFromUrl() to the client [PHPCAS-108] (Joachim Fritschi) - * Remove the PGT filestorage in xml format that is not implemented [PHPCAS-112] (Joachim Fritschi) - * Fix compatibility of the PGT db storage interface with postgres [PHPCAS-113] (Joachim Fritschi) - -Improvement - * Support for proxied POST requests. [PHPCAS-90] (Adam Franco) - * Add missing example for the new pgt-db storage [PHPCAS-101] (Joachim Fritschi) - * CASClient::getServerLoginURL(): Don't cache gateway/renew parameters [PHPCAS-105] (Bradley Froehle) - * fix parsing of cookies with special symbols in their values [PHPCAS-106] (Joachim Fritschi) - * Removal of the debug_backtrace hack for php4 [PHPCAS-110] (Joachim Fritschi) - * Clean up the naming structure of the classes [PHPCAS-111] (Joachim Fritschi) - * Better debug log output format [PHPCAS-114] (Joachim Fritschi) - * Many more examples and one central config. Improved code documentation [PHPCAS-86] (Joachim Fritschi, Adam Franco) - -Changes in version 1.2.1 - * None - -Changes in version 1.2.1RC1 -Improvements - * add support for storing PGTs in a database [PHPCAS-94] (Daniel Frett) - -Bug Fixes - * phpCAS::setDebug(FALSE) should stop logging [PHPCAS-95] (Joachim Fritschi) - * fix checkAuthenticate return value documentation [PHPCAS-92] (Joachim Fritschi) - * fix PGTStorage contructor name [PHPCAS-93] (Daniel Frett) - * fix the PHPCAS_SERVICE_NOT_AVAILABLE constant [PHPCAS-91] (Daniel Frett) - * fix redirection with multiple proxies in HTTP_X_FORWARDED_HOST [PHPCAS-98] (Joachim Fritschi) - * fix some undefinde variable warnings in debug mode [PHPCAS-96] (Joachim Fritschi) - -Changes in version 1.2.0 - * None - -Changes in version 1.2.0RC2 -Improvements - * add callback hooks during authentication and single sign-out [PHPCAS-76] (Adam Franco) - -Changes in version 1.2.0RC1 -Improvements - * add hasAttribute($key) and getAttribute($key) [PHPCAS-43] (Adam Franco) - * add unit tests for cas 2.0 attribute support [PHPCAS-88] (Adam Franco) - * expose the proxy chain through the phpcas interface [PHPCAS-89] (Adam Franco) - * add deprecation messages to the logout functions with an url parameter [PHPCAS-85] (Joachim Fritschi) - -Bug Fixes - * fix public/private modifier for some functions [PHPCAS-87] (Joachim Fritschi) - -Changes in version 1.2.0-beta1 - -Bug Fixes - * fix redirection behind a proxy. [PHPCAS-78] (Alex Barker) - * remove the bogus setCasServerCert() function and clean up the curl ssl settings [PHPCAS-84] (Joachim Fritschi) - -Improvements - * mark the logout functions with an url parameter a deprecated [PHPCAS-85] (Joachim Fritschi) - * add public/private modifier for all vars and functions [PHPCAS-77] (Joachim Fritschi) - * add a testing framwork that implement on and offline testing capabilities [PHPCAS-66] (Adam Franco) - * add RFC compliant cookie storage for the proxy() mode. [PHPCAS-54] (Adam Franco) - * removal of the domxml compatibility lib [PHPCAS-72] (Matthew Brooks, Joachim Fritschi) - * add support for attributes for the cas_2.0 protocol [PHPCAS-43] (Joachim Fritschi, Adam Franco) - * removal of unused code and comments [PHPCAS-63] (Joachim Fritschi) - * fix static function warnings for php 5.x [PHPCAS-46] (Joachim Fritschi) - -Changes in version 1.1.3 - Bug Fixes - * removal of the non functional pgt-db backend [PHPCAS-65] (Joachim Fritschi) - -Changes in version 1.1.3RC1 - Security Issue - * CVE-2010-3690 phpCAS: XSS during a proxy callback [PHPCAS-80] (Joachim Fritschi) - * CVE-2010-3691 phpCAS: prevent symlink attacks during a proxy callback [PHPCAS-80] (Joachim Fritschi) - * CVE-2010-3692 phpCAS: directory traversal during a proxy callback [PHPCAS-80] (Joachim Fritschi) - - Bug Fixes - * fix missing $this in domxml-php4-to-php5 [PHPCAS-73] (Iñaki Arenaza) - * fix broken redirection with safari [PHPCAS-79] (Alex Barker) - * fix missing exit() call during ticket validation [PHPCAS-76] (Igor Blanco,Joachim Fritschi) - * fix a notice because REQUEST_URL is not defined on IIS [PHPCAS-81] (Iñaki Arenaza) - * fix a typo in pgt-db.php [PHPCAS-75] (Julien Cochennec) - - Improvements - * upgrade domxml-php4-to-php5 to the newest version [PHPCAS-74] (Joachim Fritschi) - -Changes in version 1.1.2 - * None - -Changes in version 1.1.2RC2 - Bug Fixes - * Prevent domxml-php4-to-php5 to be inclueded twice [PHPCAS-48] (Brad Krane) - -Changes in version 1.1.2RC1 -Security Issue - * Fix a session hijacking hole CVE-2010-2795 [PHPCAS-61] (Joachim Fritschi) - * callbackurl in proxy mode should be urlencoded CVE-2010-2796 [PHPCAS-67] (Joachim Fritschi) - - Improvement - * Debuglog contains phpCAS version information [PHPCAS-62] (Joachim Fritschi) - - Bug Fixes - * Fix warnings for SAML responses without attributes [PHPCAS-59] (Joachim Fritschi) - * Fix duplicate SAML debug output [PHPCAS-64] (Joachim Fritschi) - * Providing a new ST/PT/SA during an authenticated session will be ignored - and a warning will be issued to the debug log. [PHPCAS-61] (Joachim Fritschi) - * fix 2 undefinded variable notices in serviceWeb() [PHPCAS-68] (Joachim Fritschi) - -Changes in version 1.1.1 -Improvement - * On Single Sign Out destroy any existing application session before deleting the phpcas session [PHPCAS-58] (Joachim Fritschi) - -Changes in version 1.1.1RC2 -Bug fixes - * Fix bug in handling urls containing parameters without values [PHPCAS-57] (Joe Lencioni) - * New XSS patch for PHPCAS-52 that was undone in r48507 [PHPCAS-57] (Joachim Fritschi) - -Changes in version 1.1.1RC1 -Bug fixes - * Fix bug in restoring an existing session [PHPCAS-55] (Joachim Fritschi) - -Changes in version 1.1.0 -Improvement - * Replace deprecated split() with explode(). [PHPCAS-42] (Joe Lencioni) - -Changes in version 1.1.0RC8 -Bug fixes - * Add additional comments regarding the use of serviceValidate and proxyValdiate [PHPCAS-44] (Joachim Fritschi) - * Revert all changes made to the ticket parsing in r47347 r48210 [PHPCAS-44] (Joachim Fritschi) - * Fix warning when destroying uninitialized session [PHPCAS-53] (Yann Richard,Joachim Fritschi) - -Changes in version 1.1.0RC7 -Security fixes - * Fix XSS Vulnerability. Sanatize parameters before using the url submitted by a client [PHPCAS-52] (Joachim Fritschi) - -Changes in version 1.1.0RC6 -Bug fixes - * restore any possible old session before renaming the session [PHPCAS-50] (Joachim Fritschi) - -Changes in version 1.1.0RC5 -Bug fixes - * fixed don't destroy existing sessions unless needed, more debug output [PHPCAS-50] (Joachim Fritschi) - -Changes in version 1.1.0RC4 -Bug fixes - - * fixed use PHP4 functions to parse saml11 attributes [PHPCAS-51] (Joachim Fritschi) - -Changes in version 1.1.0RC3 -Bug fixes - - * added a check for missing params [PHPCAS-42] (Joachim Fritschi) - -Changes in version 1.1.0RC2 -New features - - * added custom validation Urls [PHPCAS-45] (Joachim Fritschi). - -Bug fixes - - * fixed PGT DB storage parameter list [PHPCAS-47] (Paul Merchant, Jr.) - * fixed parsing of STs [PHPCAS-44] (Joachim Fritschi) - * fixed session initialisation [PHPCAS-50] (Joachim Fritschi) - * fixed urls with than one query parameter [PHPCAS-42] (Caio Chassot) - -Changes in version 1.1.0RC1 -New features - - * added SAML support [PHPCAS-40] (Brian Long and Matthias Crauwels). - -Bug fixes - - * fixed invalid validation URLs [PHPCAS-39] (Alex Danieli). - * removed old PHP4 references [PHPCAS-41] (Yann Richard). - * fixed curl options [PHPCAS-38] (Andy Cowling). - -Improvement - - * added accept IP addresses for allowed clients [PHPCAS-37] (Arunas Stockus) - -Changes in version 1.0.2RC1 -Bug fixes - - * fix redirections masking error messages [PHPCAS-36] (Olivier Berger) - * fixed validatePGT() failing on phpCAS::traceBegin() with newer domxml-php4-to-php5.php [PHPCAS-35] (Olivier Berger) - * Fixed missing exit() at end of callback() method [PHPCAS-34] (Olivier Berger) - * Update included domxml-php4-php5.php to most recent version now under LGPL [PHPCAS-30] (Olivier Berger) - * fixed empty $target_service in CAS_Client:serviceMail [PHPCAS-22] (Julien Marchal). - -Changes in version 1.0.1 -Bug fixes - - * fixed PEAR base install directory [PHPCAS-28] (Brett Bieber). - * fixed illegal characters in session id [PHPCAS-29] (Michael Ströder, Brett Bieber). - * fixed refresh with ticket causes authentication failure [related to PHPCAS-27] (Brett Bieber). - * fixed conflict with custom session handlers [PHPCAS-26] (Martin Gonzalez). - -Changes in version 1.0.0 -New features - - * phpCAS is now PEAR-installable (Brett Bieber). - * added method handleLogoutRequests() to handle logout requests incoming from the CAS server (Julien Marchal and Pascal Aubry, requested by Craig Andrews). - * added methods setHttpProxy(), setNetworkInterface() and setExtraCurlOptions() (Stéphane Gully). - -Enhancements - - * removed undesirable notice (Glennie Vignarajah). - * removed PEAR DB dependency when storing PGTs to the filesytem (Stéphane Gully). - -Changes in version 0.6.0 -New features - - * added methods setCasServerCert() and setCasServerCaCert() to authenticate the CAS server, and method setNoCasServerValidation() to skip the SSL checks (Pascal Aubry, requested by Andrew Petro). - * Added spanish and catalan translations (Ivan Garcia). - -Bug fix - - * fixed PGT storage path on Windows (Olivier Thebault). - -Changes in version 0.5.1 -New features - - * restored method isAuthenticated() (Julien Marchal). - -Changes in version 0.5.0 -New features - - * added japanese translation (Noriyuki Fukuoka). - * added german translation (Henrik Genssen). - * phpCAS now works for CAS v3 proxy tickets (Matt Zukowski). - * phpCAS now also works with lighttpd (Marvin Addison) - -Bug fixes - - * fixed method setHTMLFooter() (Noriyuki Fukuoka). - * fixed method setHTMLHeader() (Xavier Castanho). - * fixed method isHttps() (Henrik Genssen). - * fixed method PGTStorageDB() (Ray Lambe). - * encode all the parameters, not only '&' characters (Matthew Debus). - * fixed ST proxy tickets (Julien Marchal). - -Changes in version 0.4.23 -Enhancement - - * removed notice messages (David Lowry). - -Changes in version 0.4.22 -Bug fix - - * added default value for parameter gateway in methods setServerLoginUrl() and redirectToCas() (Velpi). - -New Feature - - * added method isSessionAuthenticated() (Brendan Arnold). - -Other change - - * removed the call to error_reporting() to allow the configuration of error reporting at server level (Pascal Aubry, requested by Sylvain Derosiaux). - -Changes in version 0.4.21 -Bug fix - - * some URLs were ill-formed in some rare circumstances (Jérôme Andrieux). - -New Feature - - * added methods setServerLoginURL() and setServerLogoutURL() (Wyman Chan). - -Changes in version 0.4.20 -New feature - - * phpCAS::checkAuthentication() implements the gateway feature of CAS (Pascal Aubry, requested by Romuald Lorthioir). - -Other change - - * phpCAS::authenticateIfNeeded() was renamed phpCAS::forceAuthentication() (Pascal Aubry). - -Changes in version 0.4.19 -New features - - * the service URL for the CAs server can be fixed with method phpCAS::setFixedServiceURL (Julien Marchal). - * the callback URL used to receive PGTs can be fixed with method phpCAS::setFixedCallbackURL() (Julien Marchal). - - * added a CAS_Client wrapper to class phpCAS for method retrievePGT() (Julien Marchal). - -Changes in version 0.4.18 -Bug fixes - - * debugging information was missing (Alexandre Boisseau). - * used an undefined variable in pgt-file.php (Alexandre Boisseau). - -Changes in version 0.4.17 -Enhancement - - * made phpCAS PHP5 compliant (Vangelis Haniotakis). - -Changes in version 0.4.16 -Enhancement - - * added the possibility not to start the session management (Vangelis Haniotakis). - -Changes in version 0.4.15 -Enhancement - - * added a hack to make phpCAS work with IIS (Vangelis Haniotakis). - -Changes in version 0.4.14 -Enhancement - - * a URL can be given to the CAS server on logout (Sébastien Gougeon and Yann Richard). - -Changes in version 0.4.13 -Bug fix - - * Removed infinite loop in debug mode (Robert Legros). - -Changes in version 0.4.12 -Enhancement - - * phpCAS now works even if the web server does not set SERVER_NAME, by relying on HTTP_HOST (Terence Chiu). - -Changes in version 0.4.11 -Bug fix - - * A typo prevented ticket validation to work correctly (Robert Legros). - -Changes in version 0.4.10 -Enhancement - - * phpCAS was previously working with PHP >= 4.3.0. A debug_backtrace() wrapper was added and get_elements_by_tagname() calls were modified to make phpCAS work with phpCAS >= 4.2.2 (Robert Legros). - -Changes in version 0.4.9 -New features - - * Added greek translation (Haniotakis Vangelis). - -Changes in version 0.4.8 -Enhancements - - * PEAR's DB.php inclusion is done only if a DB class was not already included. This eases the integration into some stand-alone tools that already include DB.php, like Tikiwiki (Pascal Aubry, requested by Terence Chiu). - -Changes in version 0.4.7 -Enhancements - - * PHP session is now destroyed when using the phpCAS::logout() method (Pascal Aubry, requested by Ruben Recaba). - * Call getenv() whenever possible instead of directly dealing with environment variables (with $_ENV['xxx']), as $_ENV is not available par default on some Windows systems (Pascal Aubry). - * Set error reporting level to E_ALL ~ E_NOTICE (Pascal Aubry). - * Added the release number in the name of the main directory of the zip distribution file (Pascal Aubry, requested by Vincent Mathieu). - * Explicitly set certificate control to get round with different curl default configurations (Wyman Chan). - -Changes in version 0.4.6 -Security bug fix - - * Credentials given to HTTP realms were given in the service URLs to the CAS server (Julien Marchal). - -Enhancements - - * phpCAS now works behind an Apache reverse proxy (Julien Marchal). - -Changes in version 0.4.5 -Enhancements - - * Developer releasing is now made by ant (Pascal Aubry). - -Bug fixes - - * CAS/PGTStorage files have been renamed to fit to Windows case insensitivity (Pascal Aubry); - * %TMP% and %TEMP% environment variables are now taken into account to set the location of the log file (Pascal Aubry). - -Changes in version 0.4.4 -Enhancement - - * ticket retrieval and validation is now made with curl (Pascal Aubry). - -Changes in version 0.4.3 -Bug fix - - * phpCAS was not exiting right after redirecting in callback mode (Julien Marchal) - -Changes in version 0.4.2 -New features - - * Authentication checking is not necessarily redirecting to the CAS server (introduced phpCAS::isAuthenticated()) (Pascal Aubry) - * phpCAS can now be used to access IMAP/POP3/NNTP services (cf phpCAS::serviceMail()) (Pascal Aubry) - -Enhancements - - * debugging informations has been improved and is now send to a separate file (/tmp/phpCAS.log by default, can be changed by phpCAS::setDebug()) (Pascal Aubry) - -Changes - - * phpCAS::authenticate() is replaced by phpCAS::authenticateIfNeeded() (semantics unchanged) (Pascal Aubry) - * phpCAS::service() is replaced by phpCAS::serviceWeb() (semantics unchanged) (Pascal Aubry) - * phpCAS::setDebug() accepts FALSE (to stop debugging) or the name of a file (to log informations) (Pascal Aubry) - -Changes in version 0.4.1 -New features - - * Sessionning between CAS proxies and services (Pascal Aubry) - -Changes in version 0.4 -New features - - * CAS proxies can be chained (Pascal Aubry) - * improved error printing and debugging (introduced phpCAS::error()) (Pascal Aubry) - -Enhancements - - * proxy parameter removed from phpCAS::client() and introduced phpCAS::proxy() (Pascal Aubry) - * moved history from CAS/doc.php to history.php (create_version script updated accordingly) (Pascal Aubry) - * improved type-checking and controls for phpCAS methods (Pascal Aubry) - -Changes in version 0.3.2 -New features - - * CAS proxies now work with HTTP (HTTPS only used for callbacks) (Pascal Aubry) - -Changes in version 0.3.1 -Bug fixes - - * syntax error in CAS/Client.php (Julien Marchal) - -Changes in version 0.3 -New features - - * CAS proxies are now supported (but no PGT retrieving for proxied client) (Pascal Aubry) - * introduced phpCAS container (Pascal Aubry) - -Bug fixes - - * CAS_LANG_DEFAULT is now taken into account (Pascal Aubry) - -TODO - - * support for PGT storage to databases (Pascal Aubry) - * PGT retrieving for proxied clients (Pascal Aubry) - -Version 0.2 -Features (Pascal Aubry) - - * `Basic' (1.0) CAS mechanism supported (CAS proxies not implemented) - * Support for CAS versions 1.0 and 2.0 URL's - * Debug mode - * Customization of all output pages - * Internationalization (english and french, looking for translators...) diff --git a/include/limesurvey/admin/classes/phpCAS/docs/Upgrading b/include/limesurvey/admin/classes/phpCAS/docs/Upgrading deleted file mode 100644 index 27df91f4..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/Upgrading +++ /dev/null @@ -1,100 +0,0 @@ -################################ -### Upgrading 1.3.1 -> 1.3.2 ### -################################ - -Due to the missing validation of the CN of the SSL certifcate it may be that -phpcas fails validation of CAS server certicates that do not match the IP/DNS -name you use in the phpcas client() or proxy() setup. -If this happens a quick workaround to change the setup to the old but unsecure -behaviour. This can be seen in the no_ssl_cn_validation example. -This is not a recommended setting and is no a secure setup! - -################################ -### Upgrading 1.2.x -> 1.3.0 ### -################################ - - ------------------------------------------------------------------- -1. Changing of the default debug.log permissions: ------------------------------------------------------------------- - -The default debug log is now created with 0600 permissions to be only readable -by the webserver - -------------------------------------------------------- -2. Changing of the behaviour of proxied applications: -------------------------------------------------------- - -If your application is being proxied (Another casified application is using -proxy tickets to access your service you need to change your configuration. The -new default configuration is now to deny any proxied use of your service unless -it is exlicitly allowed: - -If you want your service to be proxied you have to enable it (default disabled) -and define an accepable list of proxies that are allowed to proxy your service. - -Add each allowed proxy definition object. For the normal CAS_ProxyChain -class, the constructor takes an array of proxies to match. The list is in -reverse just as seen from the service. Proxies have to be defined in reverse -from the service to the user. If a user hits service A and gets proxied via -B to service C the list of acceptable on C would be array(B,A). The definition -of an individual proxy can be either a string or a regexp (preg_match is used) -that will be matched against the proxy list supplied by the cas server -when validating the proxy tickets. The strings are compared starting from -the beginning and must fully match with the proxies in the list. - -Examples: - phpCAS::allowProxyChain(new CAS_ProxyChain(array( - 'https://app.example.com/' - ))); -or - phpCAS::allowProxyChain(new CAS_ProxyChain(array( - '/^https:\/\/app[0-9]\.example\.com\/rest\//', - 'http://client.example.com/' - ))); - -For quick testing or in certain production screnarios you might want to -allow allow any other valid service to proxy your service. To do so, add -the "Any" chain: - - phpcas::allowProxyChain(new CAS_ProxyChain_Any); - -THIS SETTING IS HOWEVER NOT RECOMMENDED FOR PRODUCTION AND HAS SECURITY - IMPLICATIONS: YOU ARE ALLOWING ANY SERVICE TO ACT ON BEHALF OF A USER - ON THIS SERVICE. - - ----------------------------------------------------------------- -3. Changing of the default PGT file storage location in proxy mode: ----------------------------------------------------------------- - -The default storage of the sensitive PGT session files is the -session_save_path() now. This is a php environment dependent dir which is also -used for storing your php session data. The default permissions are also changed -to 0600 to be only readable by the webserver. - - - - ------------------------------------------------------------------- -4. The setPGTStorageFile() function has changed it parameters. ------------------------------------------------------------------- - -The setPGTStorageFile() function no longer needs an storage "format" argument. -Since the format functionality was never implemented it has now been dropped -and only the path argument is necessary. - ------------------------------------------------------------------- -5. The startSession boolean in the constructor has been changed to -changeSessionID ------------------------------------------------------------------- - -The last parameter of the constructor for has been changed from "start session" -to "change session ID". This has no negative effects on existion integrations -but will allow integration with other frameworks to take advantage of single -sign-out if they switch to "true". phpCAS will then rename the session id -(keeping all vars) and be able to single sign-out users. - - - - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/config.example.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/config.example.php deleted file mode 100644 index 2ada01ca..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/config.example.php +++ /dev/null @@ -1,104 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -$phpcas_path = '../../source/'; - -/////////////////////////////////////// -// Basic Config of the phpCAS client // -/////////////////////////////////////// - -// Full Hostname of your CAS Server -$cas_host = 'cas.example.com'; - -// Context of the CAS Server -$cas_context = '/cas'; - -// Port of your CAS server. Normally for a https server it's 443 -$cas_port = 443; - -// Path to the ca chain that issued the cas server certificate -$cas_server_ca_cert_path = '/path/to/cachain.pem'; - -////////////////////////////////////////// -// Advanced Config for special purposes // -////////////////////////////////////////// - -// The "real" hosts of clustered cas server that send SAML logout messages -// Assumes the cas server is load balanced across multiple hosts -$cas_real_hosts = array('cas-real-1.example.com', 'cas-real-2.example.com'); - -// Client config for cookie hardening -$client_domain = '127.0.0.1'; -$client_path = 'phpcas'; -$client_secure = true; -$client_httpOnly = true; -$client_lifetime = 0; - -// Database config for PGT Storage -$db = 'pgsql:host=localhost;dbname=phpcas'; -//$db = 'mysql:host=localhost;dbname=phpcas'; -$db_user = 'phpcasuser'; -$db_password = 'mysupersecretpass'; -$db_table = 'phpcastabel'; -$driver_options = ''; - -/////////////////////////////////////////// -// End Configuration -- Don't edit below // -/////////////////////////////////////////// - -// Generating the URLS for the local cas example services for proxy testing -if (isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] == 'on') { - $curbase = 'https://' . $_SERVER['SERVER_NAME']; -} else { - $curbase = 'http://' . $_SERVER['SERVER_NAME']; -} -if ($_SERVER['SERVER_PORT'] != 80 && $_SERVER['SERVER_PORT'] != 443) { - $curbase .= ':' . $_SERVER['SERVER_PORT']; -} - -$curdir = dirname($_SERVER['REQUEST_URI']) . "/"; - -// CAS client nodes for rebroadcasting pgtIou/pgtId and logoutRequest -$rebroadcast_node_1 = 'http://cas-client-1.example.com'; -$rebroadcast_node_2 = 'http://cas-client-2.example.com'; - -// access to a single service -$serviceUrl = $curbase . $curdir . 'example_service.php'; -// access to a second service -$serviceUrl2 = $curbase . $curdir . 'example_service_that_proxies.php'; - -$pgtBase = preg_quote(preg_replace('/^http:/', 'https:', $curbase . $curdir), '/'); -$pgtUrlRegexp = '/^' . $pgtBase . '.*$/'; - -$cas_url = 'https://' . $cas_host; -if ($cas_port != '443') { - $cas_url = $cas_url . ':' . $cas_port; -} -$cas_url = $cas_url . $cas_context; - -// Set the session-name to be unique to the current script so that the client script -// doesn't share its session with a proxied script. -// This is just useful when running the example code, but not normally. -session_name( - 'session_for:' - . preg_replace('/[^a-z0-9-]/i', '_', basename($_SERVER['SCRIPT_NAME'])) -); -// Set an UTF-8 encoding header for internation characters (User attributes) -header('Content-Type: text/html; charset=utf-8'); -?> diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/create_pgt_storage_db_table.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/create_pgt_storage_db_table.php deleted file mode 100644 index 5c424c6b..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/create_pgt_storage_db_table.php +++ /dev/null @@ -1,53 +0,0 @@ - - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - - -// Dummy client because we need a 'client' object -$client = new CAS_Client( - CAS_VERSION_2_0, true, $cas_host, $cas_port, $cas_context, false -); - -// Set the torage object -$cas_obj = new CAS_PGTStorage_Db( - $client, $db, $db_user, $db_password, $db_table, $driver_options -); -$cas_obj->init(); -$cas_obj->createTable(); -?> - - - phpCAS PGT db storage table creation - - - -
-' . $db_table . ' successfully created in database ' . $db . ''; -?> -
- - \ No newline at end of file diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example.css b/include/limesurvey/admin/classes/phpCAS/docs/examples/example.css deleted file mode 100644 index bf7f6c48..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example.css +++ /dev/null @@ -1,10 +0,0 @@ -.error { - border: 1px solid #aa0000; - color: #aa0000; - padding: 5px; -} -.success { - border: 1px solid #00aa00; - color: #00aa00; - padding: 5px; -} \ No newline at end of file diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_advanced_saml11.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_advanced_saml11.php deleted file mode 100644 index 3c495180..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_advanced_saml11.php +++ /dev/null @@ -1,82 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(true); - -// Initialize phpCAS -phpCAS::client(SAML_VERSION_1_1, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -// phpCAS::setNoCasServerValidation(); - -// Handle SAML logout requests that emanate from the CAS host exclusively. -// Failure to restrict SAML logout requests to authorized hosts could -// allow denial of service attacks where at the least the server is -// tied up parsing bogus XML messages. -phpCAS::handleLogoutRequests(true, $cas_real_hosts); - -// Force CAS authentication on any page that includes this file -phpCAS::forceAuthentication(); - -// Some small code triggered by the logout button -if (isset($_REQUEST['logout'])) { - phpCAS::logout(); -} -?> - - - Advanced SAML 1.1 example - - -

Advanced SAML 1.1 example

- - -Authentication succeeded for user -. - -

User Attributes

-
    - $value) { - if (is_array($value)) { - echo '
  • ', $key, ':
      '; - foreach ($value as $item) { - echo '
    1. ', $item, '
      2. '; - } - echo '
    • '; - } else { - echo '
  • ', $key, ': ', $value, '
    • ' . PHP_EOL; - } -} - ?> -
-

Logout

- - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_custom_urls.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_custom_urls.php deleted file mode 100644 index 97c155fe..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_custom_urls.php +++ /dev/null @@ -1,70 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(true); - -// Initialize phpCAS -phpCAS::client(CAS_VERSION_2_0, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -// phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -phpCAS::setNoCasServerValidation(); - -// Override the validation url for any (ST and PT) CAS 2.0 validation -phpCAS::setServerProxyValidateURL('https://cas.example.org:1443/proxyValidate'); -// Override the validation url for any CAS 1.0 validation -//phpCAS::setServerServiceValidateURL('https://cas.example.org:1443/serviceValidate'); -//Override the validation url for any SAML11 validation -//phpCAS::setServerSamlValidateURL('https://cas.example.org:1443/samlValidate'); - -// force CAS authentication -phpCAS::forceAuthentication(); - -// at this step, the user has been authenticated by the CAS server -// and the user's login name can be read with phpCAS::getUser(). - -// logout if desired -if (isset($_REQUEST['logout'])) { - phpCAS::logout(); -} - -// for this test, simply print that the authentication was successfull -?> - - - phpCAS simple client - - -

Successfull Authentication!

- -

the user's login is .

-

phpCAS version is .

-

Logout

- - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_gateway.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_gateway.php deleted file mode 100644 index b7715c29..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_gateway.php +++ /dev/null @@ -1,71 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(true); - -// Initialize phpCAS -phpCAS::client(CAS_VERSION_2_0, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -// phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -phpCAS::setNoCasServerValidation(); - -if (isset($_REQUEST['logout'])) { - phpCAS::logout(); -} -if (isset($_REQUEST['login'])) { - phpCAS::forceAuthentication(); -} - -// check CAS authentication -$auth = phpCAS::checkAuthentication(); - -?> - - - phpCAS simple client - - - -

Successfull Authentication!

- -

the user's login is .

-

Logout

-

Guest mode

-

Login

-

phpCAS version is .

- - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_hardening.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_hardening.php deleted file mode 100644 index 25aae275..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_hardening.php +++ /dev/null @@ -1,85 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(false); - -// Harden session cookie to prevent some attacks on the cookie (e.g. XSS) -session_set_cookie_params($client_lifetime, $client_path, $client_domain, $client_secure, $client_httpOnly); - -// Initialize phpCAS -phpCAS::client(SAML_VERSION_1_1, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -// phpCAS::setNoCasServerValidation(); - -// Handle SAML logout requests that emanate from the CAS host exclusively. -// Failure to restrict SAML logout requests to authorized hosts could -// allow denial of service attacks where at the least the server is -// tied up parsing bogus XML messages. -phpCAS::handleLogoutRequests(true, $cas_real_hosts); - -// Force CAS authentication on any page that includes this file -phpCAS::forceAuthentication(); - -// Some small code triggered by the logout button -if (isset($_REQUEST['logout'])) { - phpCAS::logout(); -} -?> - - - Advanced SAML 1.1 example - - -

Advanced SAML 1.1 example

- - -Authentication succeeded for user -. - -

User Attributes

-
    - $value) { - if (is_array($value)) { - echo '
  • ', $key, ':
      '; - foreach ($value as $item) { - echo '
    1. ', $item, '
      2. '; - } - echo '
    • '; - } else { - echo '
  • ', $key, ': ', $value, '
    • ' . PHP_EOL; - } -} - ?> -
-

Logout

- - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_html.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_html.php deleted file mode 100644 index ec4ee9d0..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_html.php +++ /dev/null @@ -1,76 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(true); - -// Initialize phpCAS -phpCAS::client(CAS_VERSION_2_0, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -// phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -phpCAS::setNoCasServerValidation(); - -// customize HTML output -phpCAS::setHTMLHeader( - ' - - __TITLE__ - - -

__TITLE__

' -); -phpCAS::setHTMLFooter( - '
-
- phpCAS __PHPCAS_VERSION__, - CAS __CAS_VERSION__ (__SERVER_BASE_URL__) -
- -' -); - -// force CAS authentication -phpCAS::forceAuthentication(); - -// at this step, the user has been authenticated by the CAS server -// and the user's login name can be read with phpCAS::getUser(). - -// for this test, simply print that the authentication was successfull -?> - - - phpCAS simple client with HTML output customization - - -

Successfull Authentication!

- -

the user's login is .

-

phpCAS version is .

- - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_lang.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_lang.php deleted file mode 100644 index 1b6b3941..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_lang.php +++ /dev/null @@ -1,63 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(true); - -// Initialize phpCAS -phpCAS::client(CAS_VERSION_2_0, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -// phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -phpCAS::setNoCasServerValidation(); - -// set the language to french -phpCAS::setLang(PHPCAS_LANG_FRENCH); - -// force CAS authentication -phpCAS::forceAuthentication(); - -// at this step, the user has been authenticated by the CAS server -// and the user's login name can be read with phpCAS::getUser(). - -// moreover, a PGT was retrieved from the CAS server that will -// permit to gain accesses to new services. - -// for this test, simply print that the authentication was successfull -?> - - - Exemple d'internationalisation de phpCAS - - -

Authentification réussie !

- -

L'utilisateur connecté est .

-

La version de phpCAS est .

- - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_logout.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_logout.php deleted file mode 100644 index cdf42a79..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_logout.php +++ /dev/null @@ -1,64 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(true); - -// Initialize phpCAS -phpCAS::client(CAS_VERSION_2_0, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -// phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -phpCAS::setNoCasServerValidation(); - -// handle incoming logout requests -phpCAS::handleLogoutRequests(); - -// Or as an advanced featue handle SAML logout requests that emanate from the -// CAS host exclusively. -// Failure to restrict SAML logout requests to authorized hosts could -// allow denial of service attacks where at the least the server is -// tied up parsing bogus XML messages. -// phpCAS::handleLogoutRequests(true, $cas_real_hosts); - -// force CAS authentication -phpCAS::forceAuthentication(); - -// for this test, simply print that the authentication was successfull -?> - - - phpCAS simple client - - -

Successfull Authentication!

- -

the user's login is .

-

phpCAS version is .

- - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_no_ssl_cn_validation.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_no_ssl_cn_validation.php deleted file mode 100644 index bf5ef004..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_no_ssl_cn_validation.php +++ /dev/null @@ -1,68 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(true); - -// Initialize phpCAS -phpCAS::client(CAS_VERSION_2_0, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -// phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -// phpCAS::setNoCasServerValidation(); -// You can also disable the validation of the certficate CN. This means the -// certificate must be valid but the CN of the certificate must not match the -// IP or hostname you are using to access the server -phpCAS::setCasServerCACert($cas_server_ca_cert_path, false); - - -// force CAS authentication -phpCAS::forceAuthentication(); - -// at this step, the user has been authenticated by the CAS server -// and the user's login name can be read with phpCAS::getUser(). - -// logout if desired -if (isset($_REQUEST['logout'])) { - phpCAS::logout(); -} - -// for this test, simply print that the authentication was successfull -?> - - - phpCAS simple client - - -

Successfull Authentication!

- -

the user's login is .

-

phpCAS version is .

-

Logout

- - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_pgt_storage_db.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_pgt_storage_db.php deleted file mode 100644 index b5097628..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_pgt_storage_db.php +++ /dev/null @@ -1,74 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(true); - -// Initialize phpCAS -phpCAS::proxy(CAS_VERSION_2_0, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -// phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -phpCAS::setNoCasServerValidation(); - -// set PGT storage to file in plain format in the same directory as session files -phpCAS::setPGTStorageDB($db, $db_user, $db_password, $db_table); - -// force CAS authentication -phpCAS::forceAuthentication(); - -// at this step, the user has been authenticated by the CAS server -// and the user's login name can be read with phpCAS::getUser(). - -// moreover, a PGT was retrieved from the CAS server that will -// permit to gain accesses to new services. - -?> - - - phpCAS proxy example with PGT storage to a database - - - -

phpCAS proxy example with PGT storage to file

- -

the user's login is .

-

Response from service

-'; -} else { - echo '
'; -} -echo $output; -echo '
'; - ?> - - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_pgt_storage_file.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_pgt_storage_file.php deleted file mode 100644 index d7b420a7..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_pgt_storage_file.php +++ /dev/null @@ -1,74 +0,0 @@ - -* @author Adam Franco -* @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 -* @link https://wiki.jasig.org/display/CASC/phpCAS -*/ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(true); - -// Initialize phpCAS -phpCAS::proxy(CAS_VERSION_2_0, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -// phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -phpCAS::setNoCasServerValidation(); - -// set PGT storage to file in plain format in the same directory as session files -phpCAS::setPGTStorageFile(session_save_path()); - -// force CAS authentication -phpCAS::forceAuthentication(); - -// at this step, the user has been authenticated by the CAS server -// and the user's login name can be read with phpCAS::getUser(). - -// moreover, a PGT was retrieved from the CAS server that will -// permit to gain accesses to new services. - -?> - - - phpCAS proxy example with PGT storage to file - - - -

phpCAS proxy example with PGT storage to file

- -

the user's login is .

-

Response from service

-'; -} else { - echo '
'; -} - echo $output; - echo '
'; -?> - - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_GET.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_GET.php deleted file mode 100644 index 665d349b..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_GET.php +++ /dev/null @@ -1,98 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(true); - -// Initialize phpCAS -phpCAS::proxy(CAS_VERSION_2_0, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -// phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -phpCAS::setNoCasServerValidation(); - -// force CAS authentication -phpCAS::forceAuthentication(); - -// at this step, the user has been authenticated by the CAS server -// and the user's login name can be read with phpCAS::getUser(). - -// moreover, a PGT was retrieved from the CAS server that will -// permit to gain accesses to new services. - -?> - - - phpCAS proxy example #2 - - - -

phpCAS proxied proxy example

- -

the user's login is .

-

Response from service

-setUrl($serviceUrl); - $service->send(); - if ($service->getResponseStatusCode() == 200) { - echo '
'; - echo $service->getResponseBody(); - echo '
'; - } else { - // The service responded with an error code 404, 500, etc. - echo '
'; - echo 'The service responded with a ' - . $service->getResponseStatusCode() . ' error.'; - echo '
'; - } -} catch (CAS_ProxyTicketException $e) { - if ($e->getCode() == PHPCAS_SERVICE_PT_FAILURE) { - echo '
'; - echo "Your login has timed out. You need to log in again."; - echo '
'; - } else { - // Other proxy ticket errors are from bad request format (shouldn't happen) - // or CAS server failure (unlikely) so lets just stop if we hit those. - throw $e; - } -} catch (CAS_ProxiedService_Exception $e) { - // Something prevented the service request from being sent or received. - // We didn't even get a valid error response (404, 500, etc), so this - // might be caused by a network error or a DNS resolution failure. - // We could handle it in some way, but for now we will just stop. - throw $e; -} - - ?> - - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_POST.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_POST.php deleted file mode 100644 index 4e061f59..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_POST.php +++ /dev/null @@ -1,103 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(true); - -// Initialize phpCAS -phpCAS::proxy(CAS_VERSION_2_0, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -// phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -phpCAS::setNoCasServerValidation(); - -// force CAS authentication -phpCAS::forceAuthentication(); - -// at this step, the user has been authenticated by the CAS server -// and the user's login name can be read with phpCAS::getUser(). - -// moreover, a PGT was retrieved from the CAS server that will -// permit to gain accesses to new services. - -$serviceUrl = $curbase . $curdir . 'example_service_POST.php'; - -?> - - - phpCAS proxy POST example - - - -

phpCAS proxy POST example

- -

the user's login is .

-

Response from service

-setUrl($serviceUrl); - $service->setContentType('application/x-www-form-urlencoded'); - $service->setBody('favorite_color=blue'); - $service->send(); - if ($service->getResponseStatusCode() == 200) { - echo '
'; - echo $service->getResponseBody(); - echo '
'; - } else { - // The service responded with an error code 404, 500, etc. - echo '
'; - echo 'The service responded with a ' - . $service->getResponseStatusCode() . ' error.'; - echo $service->getResponseBody(); - echo '
'; - } -} catch (CAS_ProxyTicketException $e) { - if ($e->getCode() == PHPCAS_SERVICE_PT_FAILURE) { - echo '
'; - echo "Your login has timed out. You need to log in again."; - echo '
'; - } else { - // Other proxy ticket errors are from bad request format (shouldn't happen) - // or CAS server failure (unlikely) so lets just stop if we hit those. - throw $e; - } -} catch (CAS_ProxiedService_Exception $e) { - // Something prevented the service request from being sent or received. - // We didn't even get a valid error response (404, 500, etc), so this - // might be caused by a network error or a DNS resolution failure. - // We could handle it in some way, but for now we will just stop. - throw $e; -} - - ?> - - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_rebroadcast.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_rebroadcast.php deleted file mode 100644 index 2c9bff8f..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_rebroadcast.php +++ /dev/null @@ -1,63 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(true); - -// Initialize phpCAS -phpCAS::proxy(CAS_VERSION_2_0, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -// phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -phpCAS::setNoCasServerValidation(); - -// Set the nodes for rebroadcasting pgtIou/pgtId and logoutRequest -phpCAS::addRebroadcastNode($rebroadcast_node_1); -phpCAS::addRebroadcastNode($rebroadcast_node_2); - -// handle incoming logout requests -phpCAS::handleLogoutRequests(); - -// force CAS authentication -phpCAS::forceAuthentication(); - -// at this step, the user has been authenticated by the CAS server -// and the user's login name can be read with phpCAS::getUser(). - -?> - - - phpCAS proxy rebroadcast example - - - -

phpCAS proxy rebroadcast example

-

the user's login is .

- - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_serviceWeb.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_serviceWeb.php deleted file mode 100644 index 212918fa..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_serviceWeb.php +++ /dev/null @@ -1,71 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(true); - -// Initialize phpCAS -phpCAS::proxy(CAS_VERSION_2_0, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -// phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -phpCAS::setNoCasServerValidation(); - -// force CAS authentication -phpCAS::forceAuthentication(); - -// at this step, the user has been authenticated by the CAS server -// and the user's login name can be read with phpCAS::getUser(). - -// moreover, a PGT was retrieved from the CAS server that will -// permit to gain accesses to new services. - -?> - - - phpCAS proxied proxy example (with sessioning) - - - -

phpCAS proxied proxy example (with sessioning)

- -

the user's login is .

-

Response from service

-'; -} else { - echo '
'; -} -echo $output; -echo '
'; - ?> - - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_serviceWeb_chaining.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_serviceWeb_chaining.php deleted file mode 100644 index 0ab58ebe..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_proxy_serviceWeb_chaining.php +++ /dev/null @@ -1,71 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(true); - -// Initialize phpCAS -phpCAS::proxy(CAS_VERSION_2_0, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -// phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -phpCAS::setNoCasServerValidation(); - -// force CAS authentication -phpCAS::forceAuthentication(); - -// at this step, the user has been authenticated by the CAS server -// and the user's login name can be read with phpCAS::getUser(). - -// moreover, a PGT was retrieved from the CAS server that will -// permit to gain accesses to new services. - -?> - - - phpCAS proxy example #2 - - - -

phpCAS proxied proxy example

- -

the user's login is .

-

Response from service

-'; -} else { - echo '
'; -} -echo $output; -echo '
'; - ?> - - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_renew.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_renew.php deleted file mode 100644 index c25c2b81..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_renew.php +++ /dev/null @@ -1,72 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(true); - -// Initialize phpCAS -phpCAS::client(CAS_VERSION_2_0, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -// phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -phpCAS::setNoCasServerValidation(); - -// force CAS authentication -phpCAS::renewAuthentication(); - -// at this step, the user has been authenticated by the CAS server -// and the user's login name can be read with phpCAS::getUser(). - -// logout if desired -if (isset($_REQUEST['logout'])) { - phpCAS::logout(); -} - -// logout if desired -if (isset($_REQUEST['session'])) { - session_unset(); - session_destroy(); - unset($_REQUEST['session']); - header("Location: ".$_SERVER['PHP_SELF']); -} - -// for this test, simply print that the authentication was successfull -?> - - - phpCAS simple client - - -

Successfull Authentication!

- -

the user's login is .

-

phpCAS version is .

-

Logout

-

Kill local Session

- - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_service.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_service.php deleted file mode 100644 index dc5aa411..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_service.php +++ /dev/null @@ -1,96 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(true); - -// Initialize phpCAS -phpCAS::client(CAS_VERSION_2_0, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -// phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -phpCAS::setNoCasServerValidation(); - -// If you want your service to be proxied you have to enable it (default -// disabled) and define an accepable list of proxies that are allowed to -// proxy your service. -// -// Add each allowed proxy definition object. For the normal CAS_ProxyChain -// class, the constructor takes an array of proxies to match. The list is in -// reverse just as seen from the service. Proxies have to be defined in reverse -// from the service to the user. If a user hits service A and gets proxied via -// B to service C the list of acceptable on C would be array(B,A). The definition -// of an individual proxy can be either a string or a regexp (preg_match is used) -// that will be matched against the proxy list supplied by the cas server -// when validating the proxy tickets. The strings are compared starting from -// the beginning and must fully match with the proxies in the list. -// Example: -// phpCAS::allowProxyChain(new CAS_ProxyChain(array( -// 'https://app.example.com/' -// ))); -// phpCAS::allowProxyChain(new CAS_ProxyChain(array( -// '/^https:\/\/app[0-9]\.example\.com\/rest\//', -// 'http://client.example.com/' -// ))); -phpCAS::allowProxyChain(new CAS_ProxyChain(array($pgtUrlRegexp))); -phpCAS::allowProxyChain( - new CAS_ProxyChain( - array('/^' . $pgtBase . 'example_service_that_proxies.php$/', - '/^' . $pgtBase . 'example_proxy_serviceWeb_chaining.php$/' - ) - ) -); - -// For quick testing or in certain production screnarios you might want to -// allow allow any other valid service to proxy your service. To do so, add -// the "Any" chain: -// phpcas::allowProxyChain(new CAS_ProxyChain_Any); -// THIS SETTING IS HOWEVER NOT RECOMMENDED FOR PRODUCTION AND HAS SECURITY -// IMPLICATIONS: YOU ARE ALLOWING ANY SERVICE TO ACT ON BEHALF OF A USER -// ON THIS SERVICE. -//phpcas::allowProxyChain(new CAS_ProxyChain_Any); - -// force CAS authentication -phpCAS::forceAuthentication(); - -print '

I am a service that can be proxied.

'; - -// at this step, the user has been authenticated by the CAS server -// and the user's login name can be read with phpCAS::getUser(). -require 'script_info.php'; - -// for this test, simply print that the authentication was successfull -echo '

The user\'s login is ' . phpCAS::getUser() . '.

'; - -// increment the number of requests of the session and print it -if (!isset($_SESSION['n'])) { - $_SESSION['n'] = 0; -} -echo '

request #' . (++$_SESSION['n']) . '

'; - -?> diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_service_POST.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_service_POST.php deleted file mode 100644 index 74be4dfa..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_service_POST.php +++ /dev/null @@ -1,105 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(true); - -// Initialize phpCAS -phpCAS::client(CAS_VERSION_2_0, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -// phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -phpCAS::setNoCasServerValidation(); - -// If you want your service to be proxied you have to enable it (default -// disabled) and define an accepable list of proxies that are allowed to -// proxy your service. -// -// Add each allowed proxy definition object. For the normal CAS_ProxyChain -// class, the constructor takes an array of proxies to match. The list is in -// reverse just as seen from the service. Proxies have to be defined in reverse -// from the service to the user. If a user hits service A and gets proxied via -// B to service C the list of acceptable on C would be array(B,A). The definition -// of an individual proxy can be either a string or a regexp (preg_match is used) -// that will be matched against the proxy list supplied by the cas server -// when validating the proxy tickets. The strings are compared starting from -// the beginning and must fully match with the proxies in the list. -// Example: -// phpCAS::allowProxyChain(new CAS_ProxyChain(array( -// 'https://app.example.com/' -// ))); -// phpCAS::allowProxyChain(new CAS_ProxyChain(array( -// '/^https:\/\/app[0-9]\.example\.com\/rest\//', -// 'http://client.example.com/' -// ))); -phpCAS::allowProxyChain(new CAS_ProxyChain(array($pgtUrlRegexp))); - -// For quick testing or in certain production screnarios you might want to -// allow allow any other valid service to proxy your service. To do so, add -// the "Any" chain: -// phpcas::allowProxyChain(new CAS_ProxyChain_Any); -// THIS SETTING IS HOWEVER NOT RECOMMENDED FOR PRODUCTION AND HAS SECURITY -// IMPLICATIONS: YOU ARE ALLOWING ANY SERVICE TO ACT ON BEHALF OF A USER -// ON THIS SERVICE. -//phpcas::allowProxyChain(new CAS_ProxyChain_Any); - -// force CAS authentication -phpCAS::forceAuthentication(); - -if ($_SERVER['REQUEST_METHOD'] != 'POST') { - header('HTTP/1.1 400 Bad Request'); - print - "

I only respond to POST requests. This is a " - . $_SERVER['REQUEST_METHOD'] . " request.

"; - exit; -} -if (empty($_POST['favorite_color'])) { - header('HTTP/1.1 400 Bad Request'); - print '

You must post a favorite_color.

'; - exit; -} - -print '

I am a service that responds to POST requests.

'; - -// at this step, the user has been authenticated by the CAS server -// and the user's login name can be read with phpCAS::getUser(). -require 'script_info.php'; - -// for this test, simply print that the authentication was successfull -echo '

The user\'s login is ' . phpCAS::getUser() . '.

'; - -print - '

Your favorite color is ' . htmlentities($_POST['favorite_color']) - . '

'; - -// increment the number of requests of the session and print it -if (!isset($_SESSION['n'])) { - $_SESSION['n'] = 0; -} -echo '

request #' . (++$_SESSION['n']) . '

'; - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_service_that_proxies.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_service_that_proxies.php deleted file mode 100644 index 7313ebf2..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_service_that_proxies.php +++ /dev/null @@ -1,106 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(true); - -// Initialize phpCAS -phpCAS::proxy(CAS_VERSION_2_0, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -// phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -phpCAS::setNoCasServerValidation(); - -// If you want your service to be proxied you have to enable it (default -// disabled) and define an accepable list of proxies that are allowed to -// proxy your service. -// -// Add each allowed proxy definition object. For the normal CAS_ProxyChain -// class, the constructor takes an array of proxies to match. The list is in -// reverse just as seen from the service. Proxies have to be defined in reverse -// from the service to the user. If a user hits service A and gets proxied via -// B to service C the list of acceptable on C would be array(B,A). The definition -// of an individual proxy can be either a string or a regexp (preg_match is used) -// that will be matched against the proxy list supplied by the cas server -// when validating the proxy tickets. The strings are compared starting from -// the beginning and must fully match with the proxies in the list. -// Example: -// phpCAS::allowProxyChain(new CAS_ProxyChain(array( -// 'https://app.example.com/' -// ))); -// phpCAS::allowProxyChain(new CAS_ProxyChain(array( -// '/^https:\/\/app[0-9]\.example\.com\/rest\//', -// 'http://client.example.com/' -// ))); -phpCAS::allowProxyChain(new CAS_ProxyChain(array($pgtUrlRegexp))); - -// For quick testing or in certain production screnarios you might want to -// allow allow any other valid service to proxy your service. To do so, add -// the "Any" chain: -// phpcas::allowProxyChain(new CAS_ProxyChain_Any); -// THIS SETTING IS HOWEVER NOT RECOMMENDED FOR PRODUCTION AND HAS SECURITY -// IMPLICATIONS: YOU ARE ALLOWING ANY SERVICE TO ACT ON BEHALF OF A USER -// ON THIS SERVICE. -//phpcas::allowProxyChain(new CAS_ProxyChain_Any); - -// force CAS authentication -phpCAS::forceAuthentication(); - -// at this step, the user has been authenticated by the CAS server -// and the user's login name can be read with phpCAS::getUser(). - -// moreover, a PGT was retrieved from the CAS server that will -// permit to gain accesses to new services. - - - -?> - - - phpCAS proxied proxy service example - - - -

I am a service that can be proxied. In turn, I proxy another service.

- -

the user's login is .

-

Response from service

-'; -} else { - echo '
'; -} - echo $output; - echo '
'; -?> - - - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_simple.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/example_simple.php deleted file mode 100644 index 105668ac..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/example_simple.php +++ /dev/null @@ -1,63 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ - -// Load the settings from the central config file -require_once 'config.php'; -// Load the CAS lib -require_once $phpcas_path . '/CAS.php'; - -// Enable debugging -phpCAS::setDebug(); -// Enable verbose error messages. Disable in production! -phpCAS::setVerbose(true); - -// Initialize phpCAS -phpCAS::client(CAS_VERSION_2_0, $cas_host, $cas_port, $cas_context); - -// For production use set the CA certificate that is the issuer of the cert -// on the CAS server and uncomment the line below -// phpCAS::setCasServerCACert($cas_server_ca_cert_path); - -// For quick testing you can disable SSL validation of the CAS server. -// THIS SETTING IS NOT RECOMMENDED FOR PRODUCTION. -// VALIDATING THE CAS SERVER IS CRUCIAL TO THE SECURITY OF THE CAS PROTOCOL! -phpCAS::setNoCasServerValidation(); - -// force CAS authentication -phpCAS::forceAuthentication(); - -// at this step, the user has been authenticated by the CAS server -// and the user's login name can be read with phpCAS::getUser(). - -// logout if desired -if (isset($_REQUEST['logout'])) { - phpCAS::logout(); -} - -// for this test, simply print that the authentication was successfull -?> - - - phpCAS simple client - - -

Successfull Authentication!

- -

the user's login is .

-

phpCAS version is .

-

Logout

- - diff --git a/include/limesurvey/admin/classes/phpCAS/docs/examples/script_info.php b/include/limesurvey/admin/classes/phpCAS/docs/examples/script_info.php deleted file mode 100644 index 0a6c954a..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/examples/script_info.php +++ /dev/null @@ -1,20 +0,0 @@ - - * @author Adam Franco - * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0 - * @link https://wiki.jasig.org/display/CASC/phpCAS - */ ?> -
-
Current script
-
session_name():
-
session_id():
-
\ No newline at end of file diff --git a/include/limesurvey/admin/classes/phpCAS/docs/images/esup-portail.png b/include/limesurvey/admin/classes/phpCAS/docs/images/esup-portail.png deleted file mode 100644 index ed6e6661b6612ac6571e0d0eafe7991e3da75eb3..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2621 zcmds2dpK148vZe+q>xLAw!2-aq%7N|2peS@rV=}fLR#pdX}d&8Lc8`nfg4N=*QI)_lE*7?@_bIzaVzwV! z&VXv0Vnkv@UiET>2(ddjZZ19vxl;cXd*9g2I+NpZ#>d~c-lxrG$L0`s z+g4FX`NCkme=cjNUl@FaP+jf3E?s}sUn8NX_N{+vH`m-xCR18%?B#ny_+rWOZ$<>m$#Mb7}vmeT$7U~rYvKK457ilDgzc?LH z>To-~%=p-p(xiEvz^2e}@cf6gh@O=F{N0s5-0&21REG%0=_+vq$E)J(pYD(d^f{jgCt$ zboojOc*`?PYn7)b)<%99xW3{YxAG4Ip6Cg;vos-def)eIWA4Fx*UZ_a`3CQuMNiCh zXY77JS^dK;E7_@LnP0iRIH)my|8FBI_jeCp-QTu`Ke08SWrwY>Yh!j!-#wl0?OzI_ zjB-+cF;_bld+g?-#~E7`8@)f8)dj^gFCWN1*5RO4w&JAcfgAQN8iXjn=!jsR%*AQo zk;hkyY(2;0J4P3D{}esbW{*mAfSvEMw|8U2E=!_ue#(p1KRs)xy=ty19<#Qvwr%3? zTJxg6WMiLATx-h(^}Me!2#Exik#2cJ>s^x<3es^hx+HK69clOwH%{Jtz+_{Oy2t0ek$r?#9gG%G}hM z-4&Z!T#ZxfE;w724?AOVU!+EjV6o3lpV_AOKX0!YvHUfn*xGz*Ti%?H>|uLh{F5>6 zc7fD3Zq=SIk4(}spL2X<0&$_yJ3Zgf8soJ`uT{Qp(2L3OJ$ZM}`W()h(bTAtX>%JR znnR|%UcGG(>r&JFqx1VB%^BYM7j4s2!vmbY1l$R1-!LS+IkdND!S-8T^D8bis5Y2N zxp8H-q(E8`n<(kSaalXgJ6LH)jdDUAcXm1Z4wdp_bi0l0xh8>lVwgQn9=L30rOmn1 zd+O|1U=>Fol}0Hzq!rqmCRaO3MtnV~v zEYp&TGbi3@+;rGAIJV_#5kg-GwWDBbkDbqms^`m63v2( z!ul*9^V+MuS^9rRy;eCrwdgX-Va^eyZ%NfM)ius1g`Gc7N*=OYEw32mcPL7w;|~aW zwkJDR?E~NSW3#o2Dj}PSZ>zs(oe^evsHj;`V3Ve`IQ+5t%RtBA+LKOMp3`*8o~g3Z zz9w0=wFgNFl@de7^>W;KZa04nO8pnJqDyuF diff --git a/include/limesurvey/admin/classes/phpCAS/docs/images/jasig.png b/include/limesurvey/admin/classes/phpCAS/docs/images/jasig.png deleted file mode 100644 index 38952bd2f72dba1b6cd6d9fe0ee5ac9dd191ce87..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2384 zcmZ9Odpr~R8^=eHODMVL(&-Q_x5#a7$03oL32jnX zjBt>#?VyD=#9R`VOEx7Oo%8#>ey`W>kLP(_-}m?XJm0^b*XNV*8~BWjl$sO(0FZHY zaq`@)RlDIUA-bEFjaCot7D>2^Ukm^s+xa6zdZI|zcA2QFlY@7B(GtWUiszzYc*^p4 z4baSu;;`*7nX)CV><0u<`aQF7gSjqlxU;@bfd(J(dwuX=F`a6cE9^8UY0;x%Ty2gm zZQtxdQcnQd{k-4Y+kaP4={dwNoTC&yt4Del-}neXqCx1 zUBx{jmov!=S3r~Qlar({51s7QdrylfMuKtr*3$ahnbEIk*Ev0pU@D}IWDTRe@Ad%C zfgH+ln>d6V;6O&=pI-T>Zso$3v@4)?i&C)%S5Dxo88G40cm8Q&Ootsj(1;us1v!wJ z>drMTZhHHhllsh4)6jMuMWH|6Cv!hw{D$3Rr4-i`8LB>KPP=*u-n&4Z2%xgK(FXPNob+L zwZMCp%=CF}mR27&)9CxwrrgL{jI|LDYFFONZ`iEpfCbA5V*sSN5)lB-Igljgy868i zr0z)>SNdtV{pp%2M@jkFtdH=apwtRSl211fMi;rs6fS3`Z&D?CH`3dW{Lv28QGo}M zsXgZG;4)QOmV=BCmwgGR!_ta)iLWeb_8uSZoYYKr1VF69i3QP5LScQy#}@ad*5brb zT~=&n1N=ztUxzL79l1f%^1oBHDh}0zy;{PoLuiTu^F}Wtp@{L{Au|;*A;0sC) z^*U7Lx|j9U7yT>oYCwTgYMdvsoVMZ?fOcCn5*~d)v};(c{{lNpuI2Epfi7y6dQ@d^ zPru_sy&pyP@n>XGHhpUv#^5A`{i}qsR$F&Cg7{jKKX;a&@b-ohgnrJ0A)hONUO0ii z^KG9rdUVflx?s7&)6Ze~tD& zJtajb%l=@_5G>WMX}rXKXUgn!lGJ6 zZ8$|}aTi&qk9Vz!HOYmGZu!0=5yFU!y%!j^V2|ZQs0BVMEomAT`()z%&_FTPqXVw`IHc@}ZN{5|5jk%tviR3P@{Z5A0&reN#&wd~*c1PX{ zml6CnHw^21Q&Wpt1V6S)=>N&?mi?X$)8q}O{Lu+qgilINLva2dO%l8NK>Fap?@01w z&`!FYq2%-=hYn~o&E2llRWo^&)GC^fMyLW>2Oe8TONupXohnm4Q#1-0P9v!^5hV$i0S^(Btah>}@msqGJ1hgGcF17zf(?QcgJtNa5h22P(>Njq`D|v$l zMHyd(IJaQ49vqa>c*YFf@Kh(@yT_H+{0(b|${m`4v9c86AkU3e9v6FkVCLVQ?{hpJ1QD;&qmg}cmTZ*3 z8lU_O6~+SI?(AJx=OXP2ZZ!|QNE(M43GHuak?+TYE}sl3R8&52kYYzHvC>b_U{LK9>Gvs9_}`JCV;uyIiq9~T#Q9(eAT_kf<2la%os)?G3q8#9;Z-66xf%ySd56g6 z++2kadf(U#JadHT=&F*`;wA2V*4Ra!BISswk z+keu}wc8r?h+)b;#XhAC*(PZooy%B2+oJ14lSgCmg6?S<@GAKJyM3sL&$a^9Hv2|i zUFkAc%d~}Sp*%irq5O}C?+QG!^Fl5f{I1c@*H x*A|f19!VPs|K&fXM1B5oX54vzlC$342fj8wLuVK*>{=v%>uIplvtKW#{0&y?&jtVh diff --git a/include/limesurvey/admin/classes/phpCAS/docs/images/phpcas.png b/include/limesurvey/admin/classes/phpCAS/docs/images/phpcas.png deleted file mode 100644 index bb3d8f06b8817205c9463107a25b549c074bd83a..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 6771 zcmbVR^-~;88zi^{cMT39Xb8>`+})kvfgr)*umCyST@QD6cMI1ymGhMyi{XAP6rm8H1iB5(N2M32KCo8EATf1RH5)~dcn{2p5z!tQhvU)CXa2R<1 zjd!yfe$Q}lWQ=l>Vw#?rXPMrb_)A^G0d0w=d-I<hU3p+DiU3GhBApr}Zht7-HEGGF5bf_S(8qP^$({o5KzQIfheCTN$A7hS$w zDs=tp!I$U+xzA_~ogS4wORqsZXPy4uR{jqYj&FBVK0}??qZ*ITiwKt|Z?zpz&;8c_ ze`4<3(Wi8OCp{_<8XA(wKwCKSr<9v4X_W_XCm5X+hd5b%lB()6S#7nMOAoX^|yPb4vOZP{c{=z1lN&*wd$c2?5q@ z!>4W`7@r}ybR)dElOjGNjJG0NZNW`#A=h90O7rN2eu$-{%VRCiT~N#J<^^b%yIK6b zn%+jJUvaK{OCDLShJ0>pzPI`Eq;L5nNmqkmF_XP|YE0wr{>QpH2ECQ|ewpch8P(^* z4&lKOc(?r}duP3N?WH+iryes>GE%SSPmvv>^G)$_w4@(|-Ar=X9nKVP*h;xT+ z8%2OneC6?;TOouc$nv_PhD){KqVc2K+6esZOlEK-U74$x{irbmhu)-|k3LS<*$V9- z#<&DNzm{UlHFq*IOOvaICN2S(7~axhE3KA|*==~T)6~?4Gt&k7z148@+vhu#%mUQE z-8uuH|3JvKtqrs=AMjRz;-5(XWL8pS1elwf_xFF@6+vb? zI4LC0GJ4VVRe`-D85gpR(<%Lr1;DSK;UU_GXv<=U?x_4g#i_lvTLh zqobutYf#@A7|yz&X|$i&PUq+Z>M%ushyU=(e@YOIS+J#~dUe`xUTs<5-ML0Ua+?Cc^Bd^<<@MTjY!#j(i+j2LGZ%#jJLR85~aK=I$1GvcWt9>EGO z5>^=GKAd{c5)$&vX&0ohj*p7ueFgViBM9#)ho))NE+`S(FzpKptThwmY%Im0k&(hw zEq*dvmVF8uE*ux;o+I)^v|-i?csSNAI2agl)ILZ|S2n#Hc=o@}p7BjaHQF4Si9{7R{E9kW3;P!`a{14;6eRME!WIH}OZqc+zF2%rYZdnltNs& zrD6-j!`&N_AT=fMTS{&U>3jKD+%i-)(Kovmv3OXGQss!t*CSthB|Ieo=_IjJ9(Lrr zFJHTB3Mjhj3KyWog^sMcoLkxj>Xwf>8&{lyTtHM3hJ~MaglL&%C4i7-Kb$tF{->NA zdowQiw)S^7mp9uO@<8p+bq)eQ1@4|Ug-J$b*Wc%**I=b2X^_UP0)yTY#^GNtG@UW&jERYeLr9RF5*P}{y{VL=5M~38TPY;z z1|9m(AvJR9q;rz4Z!>_|O2wmC86#w;yfb)BSu}*b<0-Mzatp{D)a@-?FUl4o85D?6 zP*A$bomO!H&ExFw_EWAT@_7Y^ZMlx?T!56?dgZ495^_qZ3H$B+(>~v?B!=CJ$A5SL z8^kDfk0vmy21syWa_Wrk%4QO${+pV|Dz&E|uN-{ZTx$rE#f}&$Be);pEI&`zP!+;G zMK$SFstRhg=6zH7+X3>=#H#yvymCLr55}r+!(O&hnbP@l=n2wROG1IVVqgp8qD~ zgAtrA@p5iNap~9u&3>gSqwd>K zI-nqC!(HYEVG6E<+>~!UQuTBYkNT`Rju!v%9asz!Pi5A0DF~g6W%d~N>EE~#$}cW$ z<>RR|q%P^fABfH)GEG+AvSeXpby5$HQ24|$&^W4HIjIXGo4YIDU1q-EoxLl!O{#o- zowGZ7czU|_^7(h*>=jg0Tii5BKR!EH&%mjI?o#M|Z$2@B{IpmYu7L7+-pOwMBAURl zLq}Y0%AebL!?(g!^CN2n;@bIf90rEH8^ugetA2wCZq_yRk`MXn15SC7KL*zEj7OSh zSYfHn{yKeFf~(2<`nIAAc`K`AY|M#NuD!-3W2tWitt+bPR-xwktdj8w_x7fyXjum^ zY(%W7A1EkTQ~2hyJKwt$UUBNHTj8K$&Dw~#97Gm6c2N-%muolY)QJ$$(sZJjJh)IX z0OJ0TK4B*oU8F&ze^K5+DZc&2FUKSS0`jeWd^&U&^lAY$a1*Dc5ndRPP}HK~9w+C3Rk&`}jN}!E`>z;3SsssvjZCsSB~l zhY#6@)^AmH-b1JOruW}U7@;a#h>O`J7z zU@!+wI3Ox)I_R`3w;Uzx>RSqwi_v|P8wtQxS@h?~kgB82+WuoHaHLxzZ)4TmW0NKgEED4=ukLv6fkhBQ;hB&gR3~kisH+!9(?VH;^(cp> zVa69W=-c^}q3;lH`}FXjsTsO(LbRJC;9_;!0901T^edqQvxS-Gdp%Opsxg$>ySrl* zk@348pbJ?=3vRz4C_4;KbA#b2aDK)+Pwfk%*d zp}6Y7stU(nW#_O#!7R3s0|$vz?9|_seSLLaR>n>jt7wd^x%9M3;w-WTbBhkA zbLsX?-1eaSVd;mRcqiAwIC8_Fh0fsef{4oHW+6D}*v!qe&%dhP?L~h3wy3joWLUu}npy#GPZ`1BK9K~NX+Ur1}R zTT!fNG8>d{9MaVB2q3`yAmlF0k!=S6vweIkTN7c^)Yk_m+*elC(EefnbHo&{-JUlzwQ3}K_ zQPOxWwJoE04xk_)gGJX@BV!fA3#BYUDRxI$;>^MZB#GrU|ktA`jdnlHBkSy|cELj6=(wQm)}tynC=K z|A0IJhlh{nezus2O8V2FZ-M02dMn3wH^B2>GBY6Afn2NH=-r*jY#V_2J9#kA)8pex z)p$BjdG3y(vwjvEMx-}?W1HoZtH0TrL`d|P#`W>ZNgCr!K8RFhRY*pG&yb+bs7mP% zM+lu)X-|(OTP5S}!Nw5fe)N$ZD%P1;83iRKcScAZNPV~TVXx2n`i1DGGp5%;9;iv{ z#k4pJ;>jLP|F~q>sY|B>Wa%~F2Rxu*@|b6-Jv_$lbhx;}#BXHDT3B!>VjgzW1fIhm zmL}wpRtKk$-0c2SRn!fHSj7^_z-$B)fU{9`=Uth$wc@rg052wll~%2=8ZuXJ{$NI~ zff<{uR<2X2p2ag%@82|;P=_P;zMf12bGf@oU0q%FYK3Z%lnJ`cq+uTC7%s)eqwB%8 z808<Vr z_27C0DDsAm1altq(C@M|jEsc8FzFm0SRWn3J}&-EMsBD{J*2QtD!|JWEvCLUKrwd{ zC4Yx3%^R80es+kD&o)eGGD(6dv#7Q^Ph8PQVkbwpQhT=jY%fNHK4hFz|5fY0%lCM| zRw0@7;_Rflk~=Qh8|G^DL595B{8oD5bK*b^Mi z;Kz&sK@mjUMCdyARu(I;$~2V@D7;omA{}Uibw&zgP0lsKT~YOYITVTax zFFPzQkS1U|XQEAeNu%73jfEWp3yZM`--(bYSu@;QPJz3F)wlUuAap?71Si{;KS)7N zrLZOvOAw}7>sVKL;OcJ`UkUuaG)W+GuAA#CZXfr5#dp5p`do;6*>L``4#Phe7QA5` z1h7&|%58;+IG!fN_w8c+7p%S&d_zjf&W6;Q55qEAJB)|E3}(%kgC^V<2tBoW;}8K! zOC%!cX6F3Yk*D#rDf$$-iK}W5GvuPu9mP5t|Z2kPYU~MDRf35v4 zwWx}7(;^)w(x9KH{=1nhFMgp@TS?p(#H?TFPSoMbl~MEPHe+)l7oF$l2!trYsF;_5ILUBn}f*eT`B`)DoQX*Ak2vSMFPh=L7`NVhNd^o{HZ@0#&VD2EEQ zkhN3Mfww0Mu_I)ffGr5^p7iUf4{x64xaJg(fJgE_FJP(DGHl*h(5RLwIq>)(bb10*iH`*fR7_`J%XN27!^~+$`Xc)jc+{y z@BwfVm)Vp4Uy6FKSzJWc)lr)X`dN6_#{(QcC4S9N>=rM{@j5x z>&El?$QW2+ZFh!*xR8}Qx)RG$@{9U)J{S-GW{3-&Fvs`BKXn{| zGAn3~f;TnT^}JuH`5*fTn_USeqPxJ)H9j{ZzkXyP!T<0++lKh3rec`yf9}sP;s0JM zSjD%@ri~ItaOl`sQQ-q#JS?ag@DXWtKVL0bUe-Ny4R=BeKm{8tZ@hd0u>i6S$X(xd zuWJ>YF@lestVuz6rA1YTwAE1&--}Sqx25>V)%Tv?W33N?YM1D6G0AN))>TCZQ27)M zZO@KL`ve9jCMp9Kdp|vip4Ol1nIS})W$-y7bbn7f+&k}!^qPo@TGc34&_%-JEbB)@ zP0ZTc?U3=+-F$0lcGzgEsxnD-pu}y&7R9?`+z-5ulU5$AHI5kIl7Udv zMo~dh(qo7F2j|Iwwa^t7=k*IGYHH+DvY6_-M^R!g`ywnEdFS}IXG<$9lE~$h0)zX#PTGB%Da_sTHF?7j|p2czGg$4-g%jjII#8 z8CXyHV_dCMew;hAPf(VqHQggtl(|?}=N$HdmB@f!-*|hWe|Vr!y1f$H+P7?H=s8+b zgjPIDc6B6J^ILOxbaea(OY%-`H+QNdHsU#%9X^63IxG;3ubo7_5*_SF1Kc#Og~EnCg(9WcscwV2`ad zPdl7``e=V`Qxcm08*zCw5tnxUYEW9!>@Tecv!=~%*B6+NttPxJoCDQM(a+}$?R9;o z=0`?S+zql77Zr5V`3E@IzOmOCLlG6Fk6MOMjtgS3Bo5*@$=I)mYznLtDE_^^4ounR4+D2E&8fN%O~x!)s4Q*yac? zbVL#7+6k>)##&B~$g!G!T~PQe;=~4*3Q^}}iZDraBO{laBKUqN_6Mk7R#hl*$MeHi z2r?AdNi|il2Doqr_zONQB{1dJySPG2=Z?w9y?3q@rIVABekD2ATOc~p(Vm2TyL!OZ YL&(hT=*%gA{Y8S4lTwzf68{$XKmMga_5c6? diff --git a/include/limesurvey/admin/classes/phpCAS/docs/index.html b/include/limesurvey/admin/classes/phpCAS/docs/index.html deleted file mode 100644 index d9925bb8..00000000 --- a/include/limesurvey/admin/classes/phpCAS/docs/index.html +++ /dev/null @@ -1,19 +0,0 @@ - - - - - phpCAS - - -

-

phpCAS documentation is hosted at https://wiki.jasig.org/display/CASC/phpCAS.

- -

-

 

- - - diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/Makefile b/include/limesurvey/admin/classes/xmlrpc/doc/Makefile deleted file mode 100644 index 844c0474..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/Makefile +++ /dev/null @@ -1,80 +0,0 @@ -# $Id: Makefile,v 1.13 2008/03/07 13:01:55 ggiunta Exp $ - -### USER EDITABLE VARS ### - -WEB=/var/www/xmlrpc/doc - -MKDIR=mkdir - -PHP=php - -FOP=fop - -PHPDOC=phpdoc - - -#### DO NOT TOUCH FROM HERE ONWARDS ### - -install: - ${MKDIR} -p ${WEB} - cp *.html ${WEB} - cp *.css ${WEB} - cp *.gif ${WEB} - @echo HTML version of the manual has been installed to ${WEB} - - -### the following targets are to be used for library development ### - -doc: out/index.html xmlrpc_php.pdf javadoc-out/index.html - -# tools currently used in building docs: php 5 with xsl extension, apache fop, phpdocumentor -# alternatives include doxygen, jade, saxon, xsltproc etc... - -out/index.html xmlrpc_php.pdf: xmlrpc_php.xml - -${MKDIR} out -# Jade cmd yet to be rebuilt, starting from xml file and putting output in ./out dir, e.g. -# jade -t xml -d custom.dsl xmlrpc_php.xml -# -# convertdoc command for xmlmind xxe editor -# convertdoc docb.toHTML xmlrpc_php.xml -u out -# -# saxon + xerces xml parser + saxon extensions + xslthl: adds a little syntax highligting -# (bold and italics only, no color) for php source examples... -# java \ -# -classpath c:\programmi\saxon\saxon.jar\;c:\programmi\saxon\xslthl.jar\;c:\programmi\xerces\xercesImpl.jar\;C:\htdocs\xmlrpc_cvs\docbook-xsl\extensions\saxon65.jar \ -# -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \ -# -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \ -# -Dxslthl.config=file:///c:/htdocs/xmlrpc_cvs/docbook-xsl/highlighting/xslthl-config.xml \ -# com.icl.saxon.StyleSheet -o xmlrpc_php.fo.xml xmlrpc_php.xml custom.fo.xsl use.extensions=1 -# -# custom php script that does the xslt magic - ${PHP} convert.php xmlrpc_php.xml custom.xsl out/ -# post process html files to highlight php code samples - ${PHP} highlight.php out -# convert to fo and then to pdf using apache fop - ${PHP} convert.php xmlrpc_php.xml custom.fo.xsl xmlrpc_php.fo.xml - ${FOP} xmlrpc_php.fo.xml xmlrpc_php.pdf -# -rm xmlrpc_php.fo.xml - -javadoc-out/index.html: ../lib/xmlrpc.inc ../lib/xmlrpcs.inc ../lib/xmlrpc_wrappers.inc -# generate docs out of javadoc via doxygen -# doxygen phpxmlrpc.dox -# -# generate docs out of javadoc via phpdocumentor - ${PHPDOC} -f ../lib/xmlrpc.inc,../lib/xmlrpcs.inc,../lib/xmlrpc_wrappers.inc -t javadoc-out -ti PHP-XMLRPC -o HTML:frames:default -s - -dist: doc - ${MKDIR} -p ../xmlrpc-${VERSION}/doc - -cp out/*.html ../xmlrpc-${VERSION}/doc - -cp out/*.css ../xmlrpc-${VERSION}/doc - -cp out/*.gif ../xmlrpc-${VERSION}/doc - -cp out/*.pdf ../xmlrpc-${VERSION}/doc - cp xmlrpc_php.xml ../xmlrpc-${VERSION}/doc - cp xmlrpc_php.pdf ../xmlrpc-${VERSION}/doc - cp Makefile ../xmlrpc-${VERSION}/doc - -clean: - -rm -f out/*.html - -rm -rf javadoc-out - -rm xmlrpc_php.fo.xml - -rm xmlrpc_php.pdf diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/apa.html b/include/limesurvey/admin/classes/xmlrpc/doc/apa.html deleted file mode 100644 index a7a2987d..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/apa.html +++ /dev/null @@ -1,8 +0,0 @@ - - -Appendix A. Integration with the PHP xmlrpc extension
Appendix A. Integration with the PHP xmlrpc extension
Prev   Next

Appendix A. Integration with the PHP xmlrpc extension

To be documented more...

In short: for the fastest execution possible, you can enable the php - native xmlrpc extension, and use it in conjunction with phpxmlrpc. The - following code snippet gives an example of such integration


-/*** client side ***/
$c = new xmlrpc_client('http://phpxmlrpc.sourceforge.net/server.php');

// tell the client to return raw xml as response value
$c->return_type = 'xml';

// let the native xmlrpc extension take care of encoding request parameters
$r = $c->send(xmlrpc_encode_request('examples.getStateName', $_POST['stateno']));

if ($r->faultCode())
  // HTTP transport error
  echo 'Got error '.$r->faultCode();
else
{
  // HTTP request OK, but XML returned from server not parsed yet
  $v = xmlrpc_decode($r->value());
  // check if we got a valid xmlrpc response from server
  if ($v === NULL)
    echo 'Got invalid response';
  else
  // check if server sent a fault response
  if (xmlrpc_is_fault($v))
    echo 'Got xmlrpc fault '.$v['faultCode'];
  else
    echo'Got response: '.htmlentities($v);
}
-
-
Prev   Next
Does the library support using cookies / http sessions? Home Appendix B. Substitution of the PHP xmlrpc extension
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/apb.html b/include/limesurvey/admin/classes/xmlrpc/doc/apb.html deleted file mode 100644 index f348ec6c..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/apb.html +++ /dev/null @@ -1,12 +0,0 @@ - - -Appendix B. Substitution of the PHP xmlrpc extension
Appendix B. Substitution of the PHP xmlrpc extension
Prev   Next

Appendix B. Substitution of the PHP xmlrpc extension

Yet another interesting situation is when you are using a ready-made - php application, that provides support for the XMLRPC protocol via the - native php xmlrpc extension, but the extension is not available on your - php install (e.g. because of shared hosting constraints).

Since version 2.1, the PHP-XMLRPC library provides a compatibility - layer that aims to be 100% compliant with the xmlrpc extension API. This - means that any code written to run on the extension should obtain the - exact same results, albeit using more resources and a longer processing - time, using the PHP-XMLRPC library and the extension compatibility module. - The module is part of the EXTRAS package, available as a separate download - from the sourceforge.net website, since version 0.2

Prev   Next
Appendix A. Integration with the PHP xmlrpc extension Home Appendix C. 'Enough of xmlrpcvals!': new style library usage
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/apc.html b/include/limesurvey/admin/classes/xmlrpc/doc/apc.html deleted file mode 100644 index 0f7eb373..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/apc.html +++ /dev/null @@ -1,5 +0,0 @@ - - -Appendix C. 'Enough of xmlrpcvals!': new style library usage
Appendix C. 'Enough of xmlrpcvals!': new style library usage
Prev   Next

Appendix C. 'Enough of xmlrpcvals!': new style library usage

To be documented...

In the meantime, see docs about xmlrpc_client::return_type and - xmlrpc_server::functions_parameters_types, as well as php_xmlrpc_encode, - php_xmlrpc_decode and php_xmlrpc_decode_xml

Prev   Next
Appendix B. Substitution of the PHP xmlrpc extension Home Appendix D. Usage of the debugger
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/apd.html b/include/limesurvey/admin/classes/xmlrpc/doc/apd.html deleted file mode 100644 index b36568b4..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/apd.html +++ /dev/null @@ -1,24 +0,0 @@ - - -Appendix D. Usage of the debugger
Appendix D. Usage of the debugger
Prev   

Appendix D. Usage of the debugger

A webservice debugger is included in the library to help during - development and testing.

The interface should be self-explicative enough to need little - documentation.

The most useful feature of the debugger is without doubt the "Show - debug info" option. It allows to have a screen dump of the complete http - communication between client and server, including the http headers as - well as the request and response payloads, and is invaluable when - troubleshooting problems with charset encoding, authentication or http - compression.

The debugger can take advantage of the JSONRPC library extension, to - allow debugging of JSON-RPC webservices, and of the JS-XMLRPC library - visual editor to allow easy mouse-driven construction of the payload for - remote methods. Both components have to be downloaded separately from the - sourceforge.net web pages and copied to the debugger directory to enable - the extra functionality:

  • to enable jsonrpc functionality, download the PHP-XMLRPC - EXTRAS package, and copy the file jsonrpc.inc - either to the same directory as the debugger or somewhere in your - php include path

  • to enable the visual value editing dialog, download the - JS-XMLRPC library, and copy somewhere in the web root files - visualeditor.php, - visualeditor.css and the folders - yui and img. Then edit the - debugger file controller.php and set - appropriately the variable $editorpath.

Prev   
Appendix C. 'Enough of xmlrpcvals!': new style library usage Home 
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch01.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch01.html deleted file mode 100644 index 4dc8097e..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch01.html +++ /dev/null @@ -1,10 +0,0 @@ - - -Chapter 1. Introduction
Chapter 1. Introduction
Prev   Next

Chapter 1. Introduction

Table of Contents

Acknowledgements

XML-RPC is a format devised by Userland Software for achieving - remote procedure call via XML using HTTP as the transport. XML-RPC has its - own web site, www.xmlrpc.com

This collection of PHP classes provides a framework for writing - XML-RPC clients and servers in PHP.

Main goals of the project are ease of use, flexibility and - completeness.

The original author is Edd Dumbill of Useful Information Company. As of the - 1.0 stable release, the project was opened to wider involvement and moved - to SourceForge.

A list of XML-RPC implementations for other languages such as Perl - and Python can be found on the www.xmlrpc.com site.

Acknowledgements

Daniel E. Baumann

James Bercegay

Leon Blackwell

Stephane Bortzmeyer

Daniel Convissor

Geoffrey T. Dairiki

Stefan Esser

James Flemer

Ernst de Haan

Tom Knight

Axel Kollmorgen

Peter Kocks

Daniel Krippner

S. Kuip

A. Lambert

Frederic Lecointre

Dan Libby

Arnaud Limbourg

Ernest MacDougal Campbell III

Lukasz Mach

Kjartan Mannes

Ben Margolin

Nicolay Mausz

Justin Miller

Jan Pfeifer

Giancarlo Pinerolo

Peter Russel

Jean-Jacques Sarton

Viliam Simko

Idan Sofer

Douglas Squirrel

Heiko Stübner

Anatoly Techtonik

Tommaso Trani

Eric van der Vlist

Christian Wenz

Jim Winstead

Przemyslaw Wroblewski

Bruno Zanetti Melotti

Prev   Next
XML-RPC for PHP Home Chapter 2. What's new
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch02.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch02.html deleted file mode 100644 index d8f973e8..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch02.html +++ /dev/null @@ -1,35 +0,0 @@ - - -Chapter 2. What's new
Chapter 2. What's new
Prev   Next

Chapter 2. What's new

Table of Contents

3.0.0 beta
2.2.2
2.2.1
2.2
2.1
2.0 final
2.0 Release candidate 3
2.0 Release candidate 2
2.0 Release candidate 1

Note: not all items the following list have - (yet) been fully documented, and some might not be present in any other - chapter in the manual. To find a more detailed description of new - functions and methods please take a look at the source code of the - library, which is quite thoroughly commented in javadoc-like form.

3.0.0 beta

This is the first release of the library to only support PHP 5. - Some legacy code has been removed, and support for features such as - exceptions and dateTime objects introduced.

The "beta" tag is meant to indicate the fact that the refactoring - has been more widespread than in precedent releases and that more - changes are likely to be introduced with time - the library is still - considered to be production quality.

  • improved: removed all usage of php functions deprecated in - php 5.3, usage of assign-by-ref when creating new objects - etc...

  • improved: add support for the <ex:nil/> tag used by - the apache library, both in input and output

  • improved: add support for dateTime - objects in both in php_xmlrpc_encode and as - parameter for constructor of - xmlrpcval

  • improved: add support for timestamps as parameter for - constructor of xmlrpcval

  • improved: add option 'dates_as_objects' to - php_xmlrpc_decode to return - dateTime objects for xmlrpc - datetimes

  • improved: add new method - SetCurlOptions to - xmrlpc_client to allow extra flexibility in - tweaking http config, such as explicitly binding to an ip - address

  • improved: add new method - SetUserAgent to - xmrlpc_client to to allow having different - user-agent http headers

  • improved: add a new member variable in server class to allow - fine-tuning of the encoding of returned values when the server is - in 'phpvals' mode

  • improved: allow servers in 'xmlrpcvals' mode to also - register plain php functions by defining them in the dispatch map - with an added option

  • improved: catch exceptions thrown during execution of php - functions exposed as methods by the server

  • fixed: bad encoding if same object is encoded twice using - php_xmlrpc_encode

Prev   Next
Chapter 1. Introduction Home 2.2.2
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch02s02.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch02s02.html deleted file mode 100644 index 29c09db4..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch02s02.html +++ /dev/null @@ -1,16 +0,0 @@ - - -2.2.2
2.2.2
Prev Chapter 2. What's new Next

2.2.2

Note: this might the last release of the - library that will support PHP 4. Future releases (if any) should target - php 5.0 as minimum supported version.

  • fixed: encoding of utf-8 characters outside of the BMP - plane

  • fixed: character set declarations surrounded by double - quotes were not recognized in http headers

  • fixed: be more tolerant in detection of charset in http - headers

  • fixed: fix detection of zlib.output_compression

  • fixed: use feof() to test if socket connections are to be - closed instead of the number of bytes read (rare bug when - communicating with some servers)

  • fixed: format floating point values using the correct - decimal separator even when php locale is set to one that uses - comma

  • fixed: improve robustness of the debugger when parsing weird - results from non-compliant servers

  • php warning when receiving 'false' in a bool value

  • improved: allow the add_to_map server method to add docs for - single params too

  • improved: added the possibility to wrap for exposure as - xmlrpc methods plain php class methods, object methods and even - whole classes

Prev Up Next
Chapter 2. What's new Home 2.2.1
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch02s03.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch02s03.html deleted file mode 100644 index 1ea4cac1..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch02s03.html +++ /dev/null @@ -1,9 +0,0 @@ - - -2.2.1
2.2.1
Prev Chapter 2. What's new Next

2.2.1

  • fixed: work aroung bug in php 5.2.2 which broke support of - HTTP_RAW_POST_DATA

  • fixed: is_dir parameter of setCaCertificate() method is - reversed

  • fixed: a php warning in xmlrpc_client creator method

  • fixed: parsing of '1e+1' as valid float

  • fixed: allow errorlevel 3 to work when prev. error handler was - a static method

  • fixed: usage of client::setcookie() for multiple cookies in - non-ssl mode

  • improved: support for CP1252 charset is not part or the - library but almost possible

  • improved: more info when curl is enabled and debug mode is - on

Prev Up Next
2.2.2 Home 2.2
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch02s04.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch02s04.html deleted file mode 100644 index 963d1980..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch02s04.html +++ /dev/null @@ -1,12 +0,0 @@ - - -2.2
2.2
Prev Chapter 2. What's new Next

2.2

  • fixed: debugger errors on php installs with magic_quotes_gpc - on

  • fixed: support for https connections via proxy

  • fixed: wrap_xmlrpc_method() generated code failed to properly - encode php objects

  • improved: slightly faster encoding of data which is internally - UTF-8

  • improved: debugger always generates a 'null' id for jsonrpc if - user omits it

  • new: debugger can take advantage of a graphical value builder - (it has to be downloaded separately, as part of jsxmlrpc package. - See Appendix D for more details)

  • new: support for the <NIL/> xmlrpc extension. see below - for more details

  • new: server support for the system.getCapabilities xmlrpc - extension

  • new: wrap_xmlrpc_method() - accepts two new options: debug and return_on_fault

Prev Up Next
2.2.1 Home 2.1
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch02s05.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch02s05.html deleted file mode 100644 index 2884d8c8..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch02s05.html +++ /dev/null @@ -1,49 +0,0 @@ - - -2.1
2.1
Prev Chapter 2. What's new Next

2.1

  • The wrap_php_function and - wrap_xmlrpc_method functions have been moved - out of the base library file xmlrpc.inc into - a file of their own: xmlrpc_wrappers.inc. You - will have to include() / require() it in your scripts if you have - been using those functions. For increased security, the automatic - rebuilding of php object instances out of received xmlrpc structs - in wrap_xmlrpc_method() has been disabled - (but it can be optionally re-enabled). Both - wrap_php_function() and - wrap_xmlrpc_method() functions accept many - more options to fine tune their behaviour, including one to return - the php code to be saved and later used as standalone php - script

  • The constructor of xmlrpcval() values has seen some internal - changes, and it will not throw a php warning anymore when invoked - using an unknown xmlrpc type: the error will only be written to - php error log. Also new xmlrpcval('true', 'boolean') - is not supported anymore

  • The new function - php_xmlrpc_decode_xml() will take the xml - representation of either an xmlrpc request, response or single - value and return the corresponding php-xmlrpc object - instance

  • A new function wrap_xmlrpc_server()has - been added, to wrap all (or some) of the methods exposed by a - remote xmlrpc server into a php class

  • A new file has been added: - verify_compat.php, to help users diagnose the - level of compliance of their php installation with the - library

  • Restored compatibility with php 4.0.5 (for those poor souls - still stuck on it)

  • Method xmlrpc_server->service() - now returns a value: either the response payload or xmlrpcresp - object instance

  • Method - xmlrpc_server->add_to_map() now - accepts xmlrpc methods with no param definitions

  • Documentation for single parameters of exposed methods can - be added to the dispatch map (and turned into html docs in - conjunction with a future release of the 'extras' package)

  • Full response payload is saved into xmlrpcresp object for - further debugging

  • The debugger can now generate code that wraps a remote - method into a php function (works for jsonrpc, too); it also has - better support for being activated via a single GET call (e.g. for - integration into other tools)

  • Stricter parsing of incoming xmlrpc messages: two more - invalid cases are now detected (double data - element inside array and - struct/array after scalar - inside value element)

  • More logging of errors in a lot of situations

  • Javadoc documentation of lib files (almost) complete

  • Many performance tweaks and code cleanups, plus the usual - crop of bugs fixed (see NEWS file for complete list of - bugs)

  • Lib internals have been modified to provide better support - for grafting extra functionality on top of it. Stay tuned for - future releases of the EXTRAS package (or go read Appendix - B)...

Prev Up Next
2.2 Home 2.0 final
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch02s06.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch02s06.html deleted file mode 100644 index aff93533..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch02s06.html +++ /dev/null @@ -1,11 +0,0 @@ - - -2.0 final
2.0 final
Prev Chapter 2. What's new Next

2.0 final

  • Added to the client class the possibility to use Digest and - NTLM authentication methods (when using the CURL library) for - connecting to servers and NTLM for connecting to proxies

  • Added to the client class the possibility to specify - alternate certificate files/directories for authenticating the - peer with when using HTTPS communication

  • Reviewed all examples and added a new demo file, containing - a proxy to forward xmlrpc requests to other servers (useful e.g. - for ajax coding)

  • The debugger has been upgraded to reflect the new client - capabilities

  • All known bugs have been squashed, and the lib is more - tolerant than ever of commonly-found mistakes

Prev Up Next
2.1 Home 2.0 Release candidate 3
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch02s07.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch02s07.html deleted file mode 100644 index f0342476..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch02s07.html +++ /dev/null @@ -1,14 +0,0 @@ - - -2.0 Release candidate 3
2.0 Release candidate 3
Prev Chapter 2. What's new Next

2.0 Release candidate 3

  • Added to server class the property - functions_parameters_type, that allows the - server to register plain php functions as xmlrpc methods (i.e. - functions that do not take an xmlrpcmsg object as unique - param)

  • let server and client objects serialize calls using a - specified character set encoding for the produced xml instead of - US-ASCII (ISO-8859-1 and UTF-8 supported)

  • let php_xmlrpc_decode accept xmlrpcmsg objects as valid - input

  • 'class::method' syntax is now accepted in the server - dispatch map

  • xmlrpc_clent::SetDebug() accepts - integer values instead of a boolean value, with debugging level 2 - adding to the information printed to screen the complete client - request

Prev Up Next
2.0 final Home 2.0 Release candidate 2
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch02s08.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch02s08.html deleted file mode 100644 index 1906c9ae..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch02s08.html +++ /dev/null @@ -1,13 +0,0 @@ - - -2.0 Release candidate 2
2.0 Release candidate 2
Prev Chapter 2. What's new Next

2.0 Release candidate 2

  • Added a new property of the client object: - xmlrpc_client->return_type, indicating whether - calls to the send() method will return xmlrpcresp objects whose - value() is an xmlrpcval object, a php value (automatically - decoded) or the raw xml received from the server.

  • Added in the extras dir. two new library file: - jsonrpc.inc and - jsonrpcs.inc containing new classes that - implement support for the json-rpc protocol (alpha quality - code)

  • Added a new client method: setKey($key, - $keypass) to be used in HTTPS connections

  • Added a new file containing some benchmarks in the testsuite - directory

Prev Up Next
2.0 Release candidate 3 Home 2.0 Release candidate 1
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch02s09.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch02s09.html deleted file mode 100644 index 4b321343..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch02s09.html +++ /dev/null @@ -1,78 +0,0 @@ - - -2.0 Release candidate 1
2.0 Release candidate 1
Prev Chapter 2. What's new Next

2.0 Release candidate 1

  • Support for HTTP proxies (new method: - xmlrpc_client::setProxy())

  • Support HTTP compression of both requests and responses. - Clients can specify what kind of compression they accept for - responses between deflate/gzip/any, and whether to compress the - requests. Servers by default compress responses to clients that - explicitly declare support for compression (new methods: - xmlrpc_client::setAcceptedCompression(), - xmlrpc_client::setRequestCompression()). Note that the - ZLIB php extension needs to be enabled in PHP to support - compression.

  • Implement HTTP 1.1 connections, but only if CURL is enabled - (added an extra parameter to - xmlrpc_client::xmlrpc_client to set the desired HTTP - protocol at creation time and a new supported value for the last - parameter of xmlrpc_client::send, which now can be - safely omitted if it has been specified at creation time)

    With PHP versions greater than 4.3.8 keep-alives are enabled - by default for HTTP 1.1 connections. This should yield faster - execution times when making multiple calls in sequence to the same - xml-rpc server from a single client.

  • Introduce support for cookies. Cookies to be sent to the - server with a request can be set using - xmlrpc_client::setCookie(), while cookies received from - the server are found in xmlrpcresp::cookies(). It is - left to the user to check for validity of received cookies and - decide whether they apply to successive calls or not.

  • Better support for detecting different character set encodings - of xml-rpc requests and responses: both client and server objects - will correctly detect the charset encoding of received xml, and use - an appropriate xml parser.

    Supported encodings are US-ASCII, UTF-8 and ISO-8859-1.

  • Added one new xmlrpcmsg constructor syntax, allowing usage of - a single string with the complete URL of the target server

  • Convert xml-rpc boolean values into native php values instead - of 0 and 1

  • Force the php_xmlrpc_encode function to properly - encode numerically indexed php arrays into xml-rpc arrays - (numerically indexed php arrays always start with a key of 0 and - increment keys by values of 1)

  • Prevent the php_xmlrpc_encode function from - further re-encoding any objects of class xmlrpcval that - are passed to it. This allows to call the function with arguments - consisting of mixed php values / xmlrpcval objects.

  • Allow a server to NOT respond to system.* method calls - (setting the $server->allow_system_funcs - property).

  • Implement a new xmlrpcval method to determine if a value of - type struct has a member of a given name without having to loop - trough all members: xmlrpcval::structMemExists()

  • Expand methods xmlrpcval::addArray, - addScalar and addStruct allowing extra php - values to be added to xmlrpcval objects already formed.

  • Let the xmlrpc_client::send method accept an XML - string for sending instead of an xmlrpcmsg object, to facilitate - debugging and integration with the php native xmlrpc - extension

  • Extend the php_xmlrpc_encode and - php_xmlrpc_decode functions to allow serialization and - rebuilding of PHP objects. To successfully rebuild a serialized - object, the object class must be defined in the deserializing end of - the transfer. Note that object members of type resource will be - deserialized as NULL values.

    Note that his has been implemented adding a "php_class" - attribute to xml representation of xmlrpcval of STRUCT type, which, - strictly speaking, breaks the xml-rpc spec. Other xmlrpc - implementations are supposed to ignore such an attribute (unless - they implement a brain-dead custom xml parser...), so it should be - safe enabling it in heterogeneous environments. The activation of - this feature is done by usage of an option passed as second - parameter to both php_xmlrpc_encode and - php_xmlrpc_decode.

  • Extend the php_xmlrpc_encode function to allow - automatic serialization of iso8601-conforming php strings as - datetime.iso8601 xmlrpcvals, by usage of an optional - parameter

  • Added an automatic stub code generator for converting xmlrpc - methods to php functions and vice-versa.

    This is done via two new functions: - wrap_php_function and wrap_xmlrpc_method, - and has many caveats, with php being a typeless language and - all...

    With PHP versions lesser than 5.0.3 wrapping of php functions - into xmlrpc methods is not supported yet.

  • Allow object methods to be used in server dispatch map

  • Added a complete debugger solution, in the - debugger folder

  • Added configurable server-side debug messages, controlled by - the new method xmlrpc_server::SetDebug(). At level 0, - no debug messages are sent to the client; level 1 is the same as the - old behaviour; at level 2 a lot more info is echoed back to the - client, regarding the received call; at level 3 all warnings raised - during server processing are trapped (this prevents breaking the xml - to be echoed back to the client) and added to the debug info sent - back to the client

  • New XML parsing code, yields smaller memory footprint and - faster execution times, not to mention complete elimination of the - dreaded eval() construct, so prone to code - injection exploits

  • Rewritten most of the error messages, making text more - explicative

Prev Up Next
2.0 Release candidate 2 Home Chapter 3. System Requirements
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch03.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch03.html deleted file mode 100644 index 7d985d3d..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch03.html +++ /dev/null @@ -1,13 +0,0 @@ - - -Chapter 3. System Requirements
Chapter 3. System Requirements
Prev   Next

Chapter 3. System Requirements

The library has been designed with goals of scalability and backward - compatibility. As such, it supports a wide range of PHP installs. Note - that not all features of the lib are available in every - configuration.

The minimum supported PHP version is - 5.0.

Automatic generation of xml-rpc methods from php functions is only - supported with PHP version 5.0.3 and later (note that the lib will - generate some warnings with PHP 5 in strict error reporting mode).

If you wish to use SSL or HTTP 1.1 to communicate with remote - servers, you need the "curl" extension compiled into your PHP - installation.

The "xmlrpc" native extension is not required to be compiled into - your PHP installation, but if it is, there will be no interference with - the operation of this library.

Prev   Next
2.0 Release candidate 1 Home Chapter 4. Files in the distribution
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch04.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch04.html deleted file mode 100644 index 0bf63b83..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch04.html +++ /dev/null @@ -1,31 +0,0 @@ - - -Chapter 4. Files in the distribution
Chapter 4. Files in the distribution
Prev   Next

Chapter 4. Files in the distribution

lib/xmlrpc.inc

the XML-RPC classes. include() this in - your PHP files to use the classes.

lib/xmlrpcs.inc

the XML-RPC server class. include() this - in addition to xmlrpc.inc to get server functionality

lib/xmlrpc_wrappers.inc

helper functions to "automagically" convert plain php - functions to xmlrpc services and vice versa

demo/server/proxy.php

a sample server implementing xmlrpc proxy - functionality.

demo/server/server.php

a sample server hosting various demo functions, as well as a - full suite of functions used for interoperability testing. It is - used by testsuite.php (see below) for unit testing the library, and - is not to be copied literally into your production servers

demo/client/client.php, demo/client/agesort.php, - demo/client/which.php

client code to exercise some of the functions in server.php, - including the interopEchoTests.whichToolkit - method.

demo/client/wrap.php

client code to illustrate 'wrapping' of remote methods into - php functions.

demo/client/introspect.php

client code to illustrate usage of introspection capabilities - offered by server.php.

demo/client/mail.php

client code to illustrate usage of an xmlrpc-to-email gateway - using Dave Winer's XML-RPC server at userland.com.

demo/client/zopetest.php

example client code that queries an xmlrpc server built in - Zope.

demo/vardemo.php

examples of how to construct xmlrpcval types

demo/demo1.txt, demo/demo2.txt, demo/demo3.txt

XML-RPC responses captured in a file for testing purposes (you - can use these to test the - xmlrpcmsg->parseResponse() method).

demo/server/discuss.php, - demo/client/comment.php

Software used in the PHP chapter of The Jellyfish Book to provide a comment server and allow the - attachment of comments to stories from Meerkat's data store.

test/testsuite.php, test/parse_args.php

A unit test suite for this software package. If you do - development on this software, please consider submitting tests for - this suite.

test/benchmark.php

A (very limited) benchmarking suite for this software package. - If you do development on this software, please consider submitting - benchmarks for this suite.

test/phpunit.php, test/PHPUnit/*.php

An (incomplete) version PEAR's unit test framework for PHP. - The complete package can be found at http://pear.php.net/package/PHPUnit

test/verify_compat.php

Script designed to help the user to verify the level of - compatibility of the library with the current php install

extras/test.pl, extras/test.py

Perl and Python programs to exercise server.php to test that - some of the methods work.

extras/workspace.testPhpServer.fttb

Frontier scripts to exercise the demo server. Thanks to Dave - Winer for permission to include these. See Dave's - announcement of these.

extras/rsakey.pem

A test certificate key for the SSL support, which can be used - to generate dummy certificates. It has the passphrase "test."

Prev   Next
Chapter 3. System Requirements Home Chapter 5. Known bugs and limitations
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch05.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch05.html deleted file mode 100644 index 6f7fddfe..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch05.html +++ /dev/null @@ -1,21 +0,0 @@ - - -Chapter 5. Known bugs and limitations
Chapter 5. Known bugs and limitations
Prev   Next

Chapter 5. Known bugs and limitations

This started out as a bare framework. Many "nice" bits haven't been - put in yet. Specifically, very little type validation or coercion has been - put in. PHP being a loosely-typed language, this is going to have to be - done explicitly (in other words: you can call a lot of library functions - passing them arguments of the wrong type and receive an error message only - much further down the code, where it will be difficult to - understand).

dateTime.iso8601 is supported opaquely. It can't be done natively as - the XML-RPC specification explicitly forbids passing of timezone - specifiers in ISO8601 format dates. You can, however, use the iso8601_encode() and iso8601_decode() functions - to do the encoding and decoding for you.

Very little HTTP response checking is performed (e.g. HTTP redirects - are not followed and the Content-Length HTTP header, mandated by the - xml-rpc spec, is not validated); cookie support still involves quite a bit - of coding on the part of the user.

If a specific character set encoding other than US-ASCII, ISO-8859-1 - or UTF-8 is received in the HTTP header or XML prologue of xml-rpc request - or response messages then it will be ignored for the moment, and the - content will be parsed as if it had been encoded using the charset defined - by xmlrpc_defencoding

Support for receiving from servers version 1 cookies (i.e. - conforming to RFC 2965) is quite incomplete, and might cause unforeseen - errors.

Prev   Next
Chapter 4. Files in the distribution Home Chapter 6. Support
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch06.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch06.html deleted file mode 100644 index 38716364..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch06.html +++ /dev/null @@ -1,15 +0,0 @@ - - -Chapter 6. Support
Chapter 6. Support
Prev   Next

Chapter 6. Support

Table of Contents

Online Support
The Jellyfish Book

Online Support

XML-RPC for PHP is offered "as-is" without any warranty or - commitment to support. However, informal advice and help is available - via the XML-RPC for PHP website and mailing list and from - XML-RPC.com.

  • The XML-RPC for PHP development is hosted - on phpxmlrpc.sourceforge.net. - Bugs, feature requests and patches can be posted to the project's - website.

  • The PHP XML-RPC interest mailing list is - run by the author. More details can be - found here.

  • For more general XML-RPC questions, there is a Yahoo! Groups - XML-RPC mailing - list.

  • The XML-RPC.com discussion - group is a useful place to get help with using XML-RPC. This group - is also gatewayed into the Yahoo! Groups mailing list.

Prev   Next
Chapter 5. Known bugs and limitations Home The Jellyfish Book
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch06s02.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch06s02.html deleted file mode 100644 index 238cbe4b..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch06s02.html +++ /dev/null @@ -1,11 +0,0 @@ - - -The Jellyfish Book
The Jellyfish Book
Prev Chapter 6. Support Next

The Jellyfish Book

Together with Simon St.Laurent and Joe - Johnston, Edd Dumbill wrote a book on XML-RPC for O'Reilly and - Associates on XML-RPC. It features a rather fetching jellyfish on the - cover.

Complete details of the book are available from - O'Reilly's web site.

Edd is responsible for the chapter on PHP, which includes a worked - example of creating a forum server, and hooking it up the O'Reilly's - Meerkat service in - order to allow commenting on news stories from around the Web.

If you've benefited from the effort that has been put into writing - this software, then please consider buying the book!

Prev Up Next
Chapter 6. Support Home Chapter 7. Class documentation
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch07.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch07.html deleted file mode 100644 index da9dcd85..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch07.html +++ /dev/null @@ -1,109 +0,0 @@ - - -Chapter 7. Class documentation
Chapter 7. Class documentation
Prev   Next

Chapter 7. Class documentation

Table of Contents

xmlrpcval
Notes on types
Creation
Methods
xmlrpcmsg
Creation
Methods
xmlrpc_client
Creation
Methods
Variables
xmlrpcresp
Creation
Methods
xmlrpc_server
Method handler functions
The dispatch map
Method signatures
Delaying the server response
Modifying the server behaviour
Fault reporting
'New style' servers

xmlrpcval

This is where a lot of the hard work gets done. This class enables - the creation and encapsulation of values for XML-RPC.

Ensure you've read the XML-RPC spec at http://www.xmlrpc.com/stories/storyReader$7 - before reading on as it will make things clearer.

The xmlrpcval class can store arbitrarily - complicated values using the following types: i4 int boolean - string double dateTime.iso8601 base64 array struct - null. You should refer to the spec for more information on - what each of these types mean.

Notes on types

int

The type i4 is accepted as a synonym - for int when creating xmlrpcval objects. The - xml parsing code will always convert i4 to - int: int is regarded - by this implementation as the canonical name for this type.

base64

Base 64 encoding is performed transparently to the caller when - using this type. Decoding is also transparent. Therefore you ought - to consider it as a "binary" data type, for use when you want to - pass data that is not 7-bit clean.

boolean

The php values true and - 1 map to true. All other - values (including the empty string) are converted to - false.

string

Characters <, >, ', ", &, are encoded using their - entity reference as &lt; &gt; &apos; &quot; and - &amp; All other characters outside of the ASCII range are - encoded using their character reference representation (e.g. - &#200 for é). The XML-RPC spec recommends only encoding - < & but this implementation goes further, - for reasons explained by the XML 1.0 - recommendation. In particular, using character reference - representation has the advantage of producing XML that is valid - independently of the charset encoding assumed.

null

There is no support for encoding null - values in the XML-RPC spec, but at least a couple of extensions (and - many toolkits) do support it. Before using null - values in your messages, make sure that the responding party accepts - them, and uses the same encoding convention (see ...).

Creation

The constructor is the normal way to create an - xmlrpcval. The constructor can take these - forms:

xmlrpcvalnew - xmlrpcval(void); 
 
xmlrpcvalnew - xmlrpcval(string$stringVal);
 
xmlrpcvalnew - xmlrpcval(mixed$scalarVal,
 string$scalartyp);
 
xmlrpcvalnew - xmlrpcval(array$arrayVal,
 string$arraytyp);
 

The first constructor creates an empty value, which must be - altered using the methods addScalar, - addArray or addStruct before - it can be used.

The second constructor creates a simple string value.

The third constructor is used to create a scalar value. The - second parameter must be a name of an XML-RPC type. Valid types are: - "int", "boolean", - "string", "double", - "dateTime.iso8601", "base64" or - "null".

Examples:


-$myInt = new xmlrpcvalue(1267, "int");
$myString = new xmlrpcvalue("Hello, World!", "string");
$myBool = new xmlrpcvalue(1, "boolean");
$myString2 = new xmlrpcvalue(1.24, "string"); // note: this will serialize a php float value as xmlrpc string
-
-

The fourth constructor form can be used to compose complex - XML-RPC values. The first argument is either a simple array in the - case of an XML-RPC array or an associative - array in the case of a struct. The elements of - the array must be xmlrpcval objects - themselves.

The second parameter must be either "array" - or "struct".

Examples:


-$myArray = new xmlrpcval(
  array(
    new xmlrpcval("Tom"),
    new xmlrpcval("Dick"),
    new xmlrpcval("Harry")
  ),
  "array");

// recursive struct
$myStruct = new xmlrpcval(
  array(
    "name" => new xmlrpcval("Tom", "string"),
    "age" => new xmlrpcval(34, "int"),
    "address" => new xmlrpcval(
      array(
        "street" => new xmlrpcval("Fifht Ave", "string"),
        "city" => new xmlrpcval("NY", "string")
      ), 
      "struct")
  ), 
  "struct");
-
-

See the file vardemo.php in this distribution - for more examples.

Methods

addScalar

intaddScalar(string$stringVal);
 
intaddScalar(mixed$scalarVal,
 string$scalartyp);
 

If $val is an empty - xmlrpcval this method makes it a scalar - value, and sets that value.

If $val is already a scalar value, then - no more scalars can be added and 0 is - returned.

If $val is an xmlrpcval of type array, - the php value $scalarval is added as its last - element.

If all went OK, 1 is returned, otherwise - 0.

addArray

intaddArray(array$arrayVal);
 

The argument is a simple (numerically indexed) array. The - elements of the array must be - xmlrpcval objects - themselves.

Turns an empty xmlrpcval into an - array with contents as specified by - $arrayVal.

If $val is an xmlrpcval of type array, - the elements of $arrayVal are appended to the - existing ones.

See the fourth constructor form for more information.

If all went OK, 1 is returned, otherwise - 0.

addStruct

intaddStruct(array$assocArrayVal);
 

The argument is an associative array. The elements of the - array must be xmlrpcval objects - themselves.

Turns an empty xmlrpcval into a - struct with contents as specified by - $assocArrayVal.

If $val is an xmlrpcval of type struct, - the elements of $arrayVal are merged with the - existing ones.

See the fourth constructor form for more information.

If all went OK, 1 is returned, otherwise - 0.

kindOf

stringkindOf(void); 
 

Returns a string containing "struct", "array" or "scalar" - describing the base type of the value. If it returns "undef" it - means that the value hasn't been initialised.

serialize

stringserialize(void); 
 

Returns a string containing the XML-RPC representation of this - value.

scalarVal

mixedscalarVal(void); 
 

If $val->kindOf() == "scalar", this - method returns the actual PHP-language value of the scalar (base 64 - decoding is automatically handled here).

scalarTyp

stringscalarTyp(void); 
 

If $val->kindOf() == "scalar", this - method returns a string denoting the type of the scalar. As - mentioned before, i4 is always coerced to - int.

arrayMem

xmlrpcvalarrayMem(int$n);
 

If $val->kindOf() == "array", returns - the $nth element in the array represented by - the value $val. The value returned is an - xmlrpcval object.


-// iterating over values of an array object
for ($i = 0; $i < $val->arraySize(); $i++)
{
  $v = $val->arrayMem($i);
  echo "Element $i of the array is of type ".$v->kindOf();
}
-
-

arraySize

intarraySize(void); 
 

If $val is an - array, returns the number of elements in that - array.

structMem

xmlrpcvalstructMem(string$memberName);
 

If $val->kindOf() == "struct", returns - the element called $memberName from the - struct represented by the value $val. The - value returned is an xmlrpcval object.

structEach

arraystructEach(void); 
 

Returns the next (key, value) pair from the struct, when - $val is a struct. - $value is an xmlrpcval itself. See also structreset().


-// iterating over all values of a struct object
$val->structreset();
while (list($key, $v) = $val->structEach())
{
  echo "Element $key of the struct is of type ".$v->kindOf();
}
-
-

structReset

voidstructReset(void); 
 

Resets the internal pointer for - structEach() to the beginning of the struct, - where $val is a struct.

structMemExists

boolstructMemExsists(string$memberName);
 

Returns TRUE or - FALSE depending on whether a member of the - given name exists in the struct.

Prev   Next
The Jellyfish Book Home xmlrpcmsg
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch07s02.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch07s02.html deleted file mode 100644 index 227d1610..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch07s02.html +++ /dev/null @@ -1,35 +0,0 @@ - - -xmlrpcmsg
xmlrpcmsg
Prev Chapter 7. Class documentation Next

xmlrpcmsg

This class provides a representation for a request to an XML-RPC - server. A client sends an xmlrpcmsg to a server, - and receives back an xmlrpcresp (see xmlrpc_client->send).

Creation

The constructor takes the following forms:

xmlrpcmsgnew - xmlrpcmsg(string$methodName,
 array$parameterArraynull);
 

Where methodName is a string indicating - the name of the method you wish to invoke, and - parameterArray is a simple php - Array of xmlrpcval - objects. Here's an example message to the US state - name server:


-$msg = new xmlrpcmsg("examples.getStateName", array(new xmlrpcval(23, "int")));
-
-

This example requests the name of state number 23. For more - information on xmlrpcval objects, see xmlrpcval.

Note that the parameterArray parameter is - optional and can be omitted for methods that take no input parameters - or if you plan to add parameters one by one.

Methods

addParam

booladdParam(xmlrpcval$xmlrpcVal);
 

Adds the xmlrpcval - xmlrpcVal to the parameter list for this - method call. Returns TRUE or FALSE on error.

getNumParams

intgetNumParams(void); 
 

Returns the number of parameters attached to this - message.

getParam

xmlrpcvalgetParam(int$n);
 

Gets the nth parameter in the message - (with the index zero-based). Use this method in server - implementations to retrieve the values sent by the client.

method

stringmethod(void); 
 
stringmethod(string$methName);
 

Gets or sets the method contained in the XML-RPC - message.

parseResponse

xmlrpcrespparseResponse(string$xmlString);
 

Given an incoming XML-RPC server response contained in the - string $xmlString, this method constructs an - xmlrpcresp response object and returns it, - setting error codes as appropriate (see xmlrpc_client->send).

This method processes any HTTP/MIME headers it finds.

parseResponseFile

xmlrpcrespparseResponseFile(file handle - resource$fileHandle);
 

Given an incoming XML-RPC server response on the open file - handle fileHandle, this method reads all the - data it finds and passes it to - parseResponse.

This method is useful to construct responses from pre-prepared - files (see files demo1.txt, demo2.txt, demo3.txt - in this distribution). It processes any HTTP headers it finds, and - does not close the file handle.

serialize

string - serialize(void); 
 

Returns the an XML string representing the XML-RPC - message.

Prev Up Next
Chapter 7. Class documentation Home xmlrpc_client
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch07s03.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch07s03.html deleted file mode 100644 index db0ef071..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch07s03.html +++ /dev/null @@ -1,195 +0,0 @@ - - -xmlrpc_client
xmlrpc_client
Prev Chapter 7. Class documentation Next

xmlrpc_client

This is the basic class used to represent a client of an XML-RPC - server.

Creation

The constructor accepts one of two possible syntaxes:

xmlrpc_clientnew - xmlrpc_client(string$server_url);
 
xmlrpc_clientnew - xmlrpc_client(string$server_path,
 string$server_hostname,
 int$server_port80,
 string$transport'http');
 

Here are a couple of usage examples of the first form:


-$client = new xmlrpc_client("http://phpxmlrpc.sourceforge.net/server.php");
$another_client = new xmlrpc_client("https://james:bond@secret.service.com:443/xmlrpcserver?agent=007");
-
-

The second syntax does not allow to express a username and - password to be used for basic HTTP authorization as in the second - example above, but instead it allows to choose whether xmlrpc calls - will be made using the HTTP 1.0 or 1.1 protocol.

Here's another example client set up to query Userland's XML-RPC - server at betty.userland.com:


-$client = new xmlrpc_client("/RPC2", "betty.userland.com", 80);
-
-

The server_port parameter is optional, - and if omitted will default to 80 when using HTTP and 443 when using - HTTPS (see the xmlrpc_client->send method - below).

The transport parameter is optional, and - if omitted will default to 'http'. Allowed values are either - 'http', 'https' or - 'http11'. Its value can be overridden with every call - to the send method. See the - send method below for more details about the - meaning of the different values.

Methods

This class supports the following methods.

send

This method takes the forms:

xmlrpcrespsend(xmlrpcmsg$xmlrpc_message,
 int$timeout,
 string$transport);
 
arraysend(array$xmlrpc_messages,
 int$timeout,
 string$transport);
 
xmlrpcrespsend(string$xml_payload,
 int$timeout,
 string$transport);
 

Where xmlrpc_message is an instance of - xmlrpcmsg (see xmlrpcmsg), - and response is an instance of - xmlrpcresp (see xmlrpcresp).

If xmlrpc_messages is an array of - message instances, responses will be an array of - response instances. The client will try to make use of a single - system.multicall xml-rpc method call to forward to the - server all the messages in a single HTTP round trip, unless - $client->no_multicall has been previously set to - TRUE (see the multicall method below), in which case - many consecutive xmlrpc requests will be sent.

The third syntax allows to build by hand (or any other means) - a complete xmlrpc request message, and send it to the server. - xml_payload should be a string containing the - complete xml representation of the request. It is e.g. useful when, - for maximal speed of execution, the request is serialized into a - string using the native php xmlrpc functions (see the php manual on - xmlrpc).

The timeout is optional, and will be - set to 0 (wait for platform-specific predefined - timeout) if omitted. This timeout value is passed to - fsockopen(). It is also used for detecting - server timeouts during communication (i.e. if the server does not - send anything to the client for timeout - seconds, the connection will be closed).

The transport parameter is optional, - and if omitted will default to the transport set using instance - creator or 'http' if omitted. The only other valid values are - 'https', which will use an SSL HTTP connection to connect to the - remote server, and 'http11'. Note that your PHP must have the "curl" - extension compiled in order to use both these features. Note that - when using SSL you should normally set your port number to 443, - unless the SSL server you are contacting runs at any other - port.

Warning

PHP 4.0.6 has a bug which prevents SSL working.

In addition to low-level errors, the XML-RPC server you were - querying may return an error in the - xmlrpcresp object. See xmlrpcresp for details of how to handle these - errors.

multiCall

This method takes the form:

arraymultiCall(array$messages,
 int$timeout,
 string$transport,
 bool$fallback);
 

This method is used to boxcar many method calls in a single - xml-rpc request. It will try first to make use of the - system.multicall xml-rpc method call, and fall back to - executing many separate requests if the server returns any - error.

msgs is an array of - xmlrpcmsg objects (see xmlrpcmsg), and response is an - array of xmlrpcresp objects (see xmlrpcresp).

The timeout and - transport parameters are optional, and behave - as in the send method above.

The fallback parameter is optional, and - defaults to TRUE. When set to - FALSE it will prevent the client to try using - many single method calls in case of failure of the first multicall - request. It should be set only when the server is known to support - the multicall extension.

setAcceptedCompression

voidsetAcceptedCompression(string$compressionmethod);
 

This method defines whether the client will accept compressed - xml payload forming the bodies of the xmlrpc responses received from - servers. Note that enabling reception of compressed responses merely - adds some standard http headers to xmlrpc requests. It is up to the - xmlrpc server to return compressed responses when receiving such - requests. Allowed values for - compressionmethod are: 'gzip', 'deflate', - 'any' or null (with any meaning either gzip or deflate).

This requires the "zlib" extension to be enabled in your php - install. If it is, by default xmlrpc_client - instances will enable reception of compressed content.

setCaCertificate

voidsetCaCertificate(string$certificate,
 bool$is_dir);
 

This method sets an optional certificate to be used in - SSL-enabled communication to validate a remote server with (when the - server_method is set to 'https' in the - client's construction or in the send method and - SetSSLVerifypeer has been set to - TRUE).

The certificate parameter must be the - filename of a PEM formatted certificate, or a directory containing - multiple certificate files. The is_dir - parameter defaults to FALSE, set it to - TRUE to specify that - certificate indicates a directory instead of - a single file.

This requires the "curl" extension to be compiled into your - installation of PHP. For more details see the man page for the - curl_setopt function.

setCertificate

voidsetCertificate(string$certificate,
 string$passphrase);
 

This method sets the optional certificate and passphrase used - in SSL-enabled communication with a remote server (when the - server_method is set to 'https' in the - client's construction or in the send method).

The certificate parameter must be the - filename of a PEM formatted certificate. The - passphrase parameter must contain the - password required to use the certificate.

This requires the "curl" extension to be compiled into your - installation of PHP. For more details see the man page for the - curl_setopt function.

Note: to retrieve information about the client certificate on - the server side, you will need to look into the environment - variables which are set up by the webserver. Different webservers - will typically set up different variables.

setCookie

voidsetCookie(string$name,
 string$value,
 string$path,
 string$domain,
 int$port);
 

This method sets a cookie that will be sent to the xmlrpc - server along with every further request (useful e.g. for keeping - session info outside of the xml-rpc payload).

$value is optional, and defaults to - null.

$path, $domain and $port are optional, - and will be omitted from the cookie header if unspecified. Note that - setting any of these values will turn the cookie into a 'version 1' - cookie, that might not be fully supported by the server (see RFC2965 - for more details).

setCredentials

voidsetCredentials(string$username,
 string$password,
 int$authtype);
 

This method sets the username and password for authorizing the - client to a server. With the default (HTTP) transport, this - information is used for HTTP Basic authorization. Note that username - and password can also be set using the class constructor. With HTTP - 1.1 and HTTPS transport, NTLM and Digest authentication protocols - are also supported. To enable them use the constants - CURLAUTH_DIGEST and - CURLAUTH_NTLM as values for the authtype - parameter.

setCurlOptions

voidsetCurlOptions(array$options);
 

This method allows to directly set any desired - option to manipulate the usage of the cURL client (when in cURL - mode). It can be used eg. to explicitly bind to an outgoing ip - address when the server is multihomed

setDebug

voidsetDebug(int$debugLvl);
 

debugLvl is either 0, - 1 or 2 depending on whether you require the client to - print debugging information to the browser. The default is not to - output this information (0).

The debugging information at level 1includes the raw data - returned from the XML-RPC server it was querying (including bot HTTP - headers and the full XML payload), and the PHP value the client - attempts to create to represent the value returned by the server. At - level2, the complete payload of the xmlrpc request is also printed, - before being sent t the server.

This option can be very useful when debugging servers as it - allows you to see exactly what the client sends and the server - returns.

setKey

voidsetKey(int$key,
 int$keypass);
 

This method sets the optional certificate key and passphrase - used in SSL-enabled communication with a remote server (when the - transport is set to 'https' in the client's - construction or in the send method).

This requires the "curl" extension to be compiled into your - installation of PHP. For more details see the man page for the - curl_setopt function.

setProxy

voidsetProxy(string$proxyhost,
 int$proxyport,
 string$proxyusername,
 string$proxypassword,
 int$authtype);
 

This method enables calling servers via an HTTP proxy. The - proxyusername, - proxypassword and authtype - parameters are optional. Authtype defaults to - CURLAUTH_BASIC (Basic authentication protocol); - the only other valid value is the constant - CURLAUTH_NTLM, and has effect only when the - client uses the HTTP 1.1 protocol.

NB: CURL versions before 7.11.10 cannot use a proxy to - communicate with https servers.

setRequestCompression

voidsetRequestCompression(string$compressionmethod);
 

This method defines whether the xml payload forming the - request body will be sent to the server in compressed format, as per - the HTTP specification. This is particularly useful for large - request parameters and over slow network connections. Allowed values - for compressionmethod are: 'gzip', 'deflate', - 'any' or null (with any meaning either gzip or deflate). Note that - there is no automatic fallback mechanism in place for errors due to - servers not supporting receiving compressed request bodies, so make - sure that the particular server you are querying does accept - compressed requests before turning it on.

This requires the "zlib" extension to be enabled in your php - install.

setSSLVerifyHost

voidsetSSLVerifyHost(int$i);
 

This method defines whether connections made to XML-RPC - backends via HTTPS should verify the remote host's SSL certificate's - common name (CN). By default, only the existence of a CN is checked. - $i should be an - integer value; 0 to not check the CN at all, 1 to merely check for - its existence, and 2 to check that the CN on the certificate matches - the hostname that is being connected to.

setSSLVerifyPeer

voidsetSSLVerifyPeer(bool$i);
 

This method defines whether connections made to XML-RPC - backends via HTTPS should verify the remote host's SSL certificate, - and cause the connection to fail if the cert verification fails. - $i should be a boolean - value. Default value: TRUE. To specify custom - SSL certificates to validate the server with, use the - setCaCertificate method.

setUserAgent

voidUseragent(string$useragent);
 

This method sets a custom user-agent that will be - used by the client in the http headers sent with the request. The - default value is built using the library name and version - constants.

Variables

NB: direct manipulation of these variables is only recommended - for advanced users.

no_multicall

This member variable determines whether the multicall() method - will try to take advantage of the system.multicall xmlrpc method to - dispatch to the server an array of requests in a single http - roundtrip or simply execute many consecutive http calls. Defaults to - FALSE, but it will be enabled automatically on the first failure of - execution of system.multicall.

request_charset_encoding

This is the charset encoding that will be used for serializing - request sent by the client.

If defaults to NULL, which means using US-ASCII and encoding - all characters outside of the ASCII range using their xml character - entity representation (this has the benefit that line end characters - will not be mangled in the transfer, a CR-LF will be preserved as - well as a singe LF).

Valid values are 'US-ASCII', 'UTF-8' and 'ISO-8859-1'

return_type

This member variable determines whether the value returned - inside an xmlrpcresp object as results of calls to the send() and - multicall() methods will be an xmlrpcval object, a plain php value - or a raw xml string. Allowed values are 'xmlrpcvals' (the default), - 'phpvals' and 'xml'. To allow the user to differentiate between a - correct and a faulty response, fault responses will be returned as - xmlrpcresp objects in any case. Note that the 'phpvals' setting will - yield faster execution times, but some of the information from the - original response will be lost. It will be e.g. impossible to tell - whether a particular php string value was sent by the server as an - xmlrpc string or base64 value.

Example usage:


-$client = new xmlrpc_client("phpxmlrpc.sourceforge.net/server");
$client->return_type = 'phpvals';
$message = new xmlrpcmsg("examples.getStateName", array(new xmlrpcval(23, "int")));
$resp = $client->send($message);
if ($resp->faultCode()) echo 'KO. Error: '.$resp->faultString(); else echo 'OK: got '.$resp->value();
-
-

For more details about usage of the 'xml' value, see Appendix - A.

Prev Up Next
xmlrpcmsg Home xmlrpcresp
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch07s04.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch07s04.html deleted file mode 100644 index 0506767e..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch07s04.html +++ /dev/null @@ -1,33 +0,0 @@ - - -xmlrpcresp
xmlrpcresp
Prev Chapter 7. Class documentation Next

xmlrpcresp

This class is used to contain responses to XML-RPC requests. A - server method handler will construct an - xmlrpcresp and pass it as a return value. This - same value will be returned by the result of an invocation of the - send method of the - xmlrpc_client class.

Creation

xmlrpcrespnew - xmlrpcresp(xmlrpcval$xmlrpcval);
 
xmlrpcrespnew - xmlrpcresp(0,
 int$errcode,
 string$err_string);
 

The first syntax is used when execution has happened without - difficulty: $xmlrpcval is an - xmlrpcval value with the result of the method - execution contained in it. Alternatively it can be a string containing - the xml serialization of the single xml-rpc value result of method - execution.

The second type of constructor is used in case of failure. - errcode and err_string - are used to provide indication of what has gone wrong. See xmlrpc_server for more information on passing error - codes.

Methods

faultCode

intfaultCode(void); 
 

Returns the integer fault code return from the XML-RPC - response. A zero value indicates success, any other value indicates - a failure response.

faultString

stringfaultString(void); 
 

Returns the human readable explanation of the fault indicated - by $resp->faultCode().

value

xmlrpcvalvalue(void); 
 

Returns an xmlrpcval object containing - the return value sent by the server. If the response's - faultCode is non-zero then the value returned - by this method should not be used (it may not even be an - object).

Note: if the xmlrpcresp instance in question has been created - by an xmlrpc_client object whose - return_type was set to 'phpvals', then a plain - php value will be returned instead of an - xmlrpcval object. If the - return_type was set to 'xml', an xml string will - be returned (see the return_type member var above for more - details).

serialize

stringserialize(void); 
 

Returns an XML string representation of the response (xml - prologue not included).

Prev Up Next
xmlrpc_client Home xmlrpc_server
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch07s05.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch07s05.html deleted file mode 100644 index 17453d62..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch07s05.html +++ /dev/null @@ -1,202 +0,0 @@ - - -xmlrpc_server
xmlrpc_server
Prev Chapter 7. Class documentation Next

xmlrpc_server

The implementation of this class has been kept as simple to use as - possible. The constructor for the server basically does all the work. - Here's a minimal example:


-  function foo ($xmlrpcmsg) {
    ...
    return new xmlrpcresp($some_xmlrpc_val);
  }

  class bar {
    function foobar($xmlrpcmsg) {
      ...
      return new xmlrpcresp($some_xmlrpc_val);
    }
  }

  $s = new xmlrpc_server(
    array(
      "examples.myFunc1" => array("function" => "foo"),
      "examples.myFunc2" => array("function" => "bar::foobar"),
    ));
-
-

This performs everything you need to do with a server. The single - constructor argument is an associative array from xmlrpc method names to - php function names. The incoming request is parsed and dispatched to the - relevant php function, which is responsible for returning a - xmlrpcresp object, that will be serialized back - to the caller.

Method handler functions

Both php functions and class methods can be registered as xmlrpc - method handlers.

The synopsis of a method handler function is:

xmlrpcresp $resp = function (xmlrpcmsg $msg)

No text should be echoed 'to screen' by the handler function, or - it will break the xml response sent back to the client. This applies - also to error and warning messages that PHP prints to screen unless - the appropriate parameters have been set in the php.in file. Another - way to prevent echoing of errors inside the response and facilitate - debugging is to use the server SetDebug method with debug level 3 (see - ...). Exceptions thrown duting execution of handler functions are - caught by default and a XML-RPC error reponse is generated instead. - This behaviour can be finetuned by usage of the - exception_handling member variable (see - ...).

Note that if you implement a method with a name prefixed by - system. the handler function will be invoked by the - server with two parameters, the first being the server itself and the - second being the xmlrpcmsg object.

The same php function can be registered as handler of multiple - xmlrpc methods.

Here is a more detailed example of what the handler function - foo may do:


-  function foo ($xmlrpcmsg) {
    global $xmlrpcerruser; // import user errcode base value

    $meth = $xmlrpcmsg->method(); // retrieve method name
    $par = $xmlrpcmsg->getParam(0); // retrieve value of first parameter - assumes at least one param received
    $val = $par->scalarval(); // decode value of first parameter - assumes it is a scalar value

    ...

    if ($err) {
      // this is an error condition
      return new xmlrpcresp(0, $xmlrpcerruser+1, // user error 1
        "There's a problem, Captain");
    } else {
      // this is a successful value being returned
      return new xmlrpcresp(new xmlrpcval("All's fine!", "string"));
    }
  }
-
-

See server.php in this distribution for - more examples of how to do this.

Since release 2.0RC3 there is a new, even simpler way of - registering php functions with the server. See section 5.7 - below

The dispatch map

The first argument to the xmlrpc_server - constructor is an array, called the dispatch map. - In this array is the information the server needs to service the - XML-RPC methods you define.

The dispatch map takes the form of an associative array of - associative arrays: the outer array has one entry for each method, the - key being the method name. The corresponding value is another - associative array, which can have the following members:

  • function - this - entry is mandatory. It must be either a name of a function in the - global scope which services the XML-RPC method, or an array - containing an instance of an object and a static method name (for - static class methods the 'class::method' syntax is also - supported).

  • signature - this - entry is an array containing the possible signatures (see Signatures) for the method. If this entry is present - then the server will check that the correct number and type of - parameters have been sent for this method before dispatching - it.

  • docstring - this - entry is a string containing documentation for the method. The - documentation may contain HTML markup.

  • signature_docs - this entry can be used - to provide documentation for the single parameters. It must match - in structure the 'signature' member. By default, only the - documenting_xmlrpc_server class in the - extras package will take advantage of this, since the - "system.methodHelp" protocol does not support documenting method - parameters individually.

  • parameters_type - this entry can be used - when the server is working in 'xmlrpcvals' mode (see ...) to - define one or more entries in the dispatch map as being functions - that follow the 'phpvals' calling convention. The only useful - value is currently the string phpvals.

Look at the server.php example in the - distribution to see what a dispatch map looks like.

Method signatures

A signature is a description of a method's return type and its - parameter types. A method may have more than one signature.

Within a server's dispatch map, each method has an array of - possible signatures. Each signature is an array of types. The first - entry is the return type. For instance, the method 


-<?php string examples.getStateName(int)
-
-

has the signature 


-<?php array($xmlrpcString, $xmlrpcInt)
-
-

and, assuming that it is the only possible signature for the - method, it might be used like this in server creation: 


-$findstate_sig = array(array($xmlrpcString, $xmlrpcInt));

$findstate_doc = 'When passed an integer between 1 and 51 returns the
name of a US state, where the integer is the index of that state name
in an alphabetic order.';

$s = new xmlrpc_server( array(
  "examples.getStateName" => array(
    "function" => "findstate",
    "signature" => $findstate_sig,
    "docstring" => $findstate_doc
  )));
-
-

Note that method signatures do not allow to check nested - parameters, e.g. the number, names and types of the members of a - struct param cannot be validated.

If a method that you want to expose has a definite number of - parameters, but each of those parameters could reasonably be of - multiple types, the array of acceptable signatures will easily grow - into a combinatorial explosion. To avoid such a situation, the lib - defines the global var $xmlrpcValue, which can be - used in method signatures as a placeholder for 'any xmlrpc - type':


-$echoback_sig = array(array($xmlrpcValue, $xmlrpcValue));

$findstate_doc = 'Echoes back to the client the received value, regardless of its type';

$s = new xmlrpc_server( array(
  "echoBack" => array(
    "function" => "echoback",
    "signature" => $echoback_sig, // this sig guarantees that the method handler will be called with one and only one parameter
    "docstring" => $echoback_doc
  )));
-
-

Methods system.listMethods, - system.methodHelp, - system.methodSignature and - system.multicall are already defined by the - server, and should not be reimplemented (see Reserved Methods - below).

Delaying the server response

You may want to construct the server, but for some reason not - fulfill the request immediately (security verification, for instance). - If you omit to pass to the constructor the dispatch map or pass it a - second argument of 0 this will have the desired - effect. You can then use the service() method of - the server class to service the request. For example:


-$s = new xmlrpc_server($myDispMap, 0); // second parameter = 0 prevents automatic servicing of request

// ... some code that does other stuff here

$s->service();
-
-

Note that the service method will print - the complete result payload to screen and send appropriate HTTP - headers back to the client, but also return the response object. This - permits further manipulation of the response, possibly in combination - with output buffering.

To prevent the server from sending HTTP headers back to the - client, you can pass a second parameter with a value of - TRUE to the service - method. In this case, the response payload will be returned instead of - the response object.

Xmlrpc requests retrieved by other means than HTTP POST bodies - can also be processed. For example:


-$s = new xmlrpc_server(); // not passing a dispatch map prevents automatic servicing of request

// ... some code that does other stuff here, including setting dispatch map into server object

$resp = $s->service($xmlrpc_request_body, true); // parse a variable instead of POST body, retrieve response payload

// ... some code that does other stuff with xml response $resp here
-
-

Modifying the server behaviour

A couple of methods / class variables are available to modify - the behaviour of the server. The only way to take advantage of their - existence is by usage of a delayed server response (see above)

setDebug()

This function controls weather the server is going to echo - debugging messages back to the client as comments in response body. - Valid values: 0,1,2,3, with 1 being the default. At level 0, no - debug info is returned to the client. At level 2, the complete - client request is added to the response, as part of the xml - comments. At level 3, a new PHP error handler is set when executing - user functions exposed as server methods, and all non-fatal errors - are trapped and added as comments into the response.

allow_system_funcs

Default_value: TRUE. When set to FALSE, disables support for - System.xxx functions in the server. It - might be useful e.g. if you do not wish the server to respond to - requests to System.ListMethods.

compress_response

When set to TRUE, enables the server to take advantage of HTTP - compression, otherwise disables it. Responses will be transparently - compressed, but only when an xmlrpc-client declares its support for - compression in the HTTP headers of the request.

Note that the ZLIB php extension must be installed for this to - work. If it is, compress_response will default to - TRUE.

exception_handling

This variable controls the behaviour of the server when an - exception is thrown by a method handler php function. Valid values: - 0,1,2, with 0 being the default. At level 0, the server catches the - exception and return an 'internal error' xmlrpc response; at 1 it - catches the exceptions and return an xmlrpc response with the error - code and error message corresponding to the exception that was - thron; at 2 = the exception is floated to the upper layers in the - code

response_charset_encoding

Charset encoding to be used for response (only affects string - values).

If it can, the server will convert the generated response from - internal_encoding to the intended one.

Valid values are: a supported xml encoding (only UTF-8 and - ISO-8859-1 at present, unless mbstring is enabled), null (leave - charset unspecified in response and convert output stream to - US_ASCII), 'default' (use xmlrpc library default as specified in - xmlrpc.inc, convert output stream if needed), or 'auto' (use - client-specified charset encoding or same as request if request - headers do not specify it (unless request is US-ASCII: then use - library default anyway).

Fault reporting

Fault codes for your servers should start at the value indicated - by the global $xmlrpcerruser + 1.

Standard errors returned by the server include:

1 Unknown method

Returned if the server was asked to dispatch a method it - didn't know about

2 Invalid return - payload

This error is actually generated by the client, not - server, code, but signifies that a server returned something it - couldn't understand. A more detailed error report is sometimes - added onto the end of the phrase above.

3 Incorrect - parameters

This error is generated when the server has signature(s) - defined for a method, and the parameters passed by the client do - not match any of signatures.

4 Can't introspect: method - unknown

This error is generated by the builtin - system.* methods when any kind of - introspection is attempted on a method undefined by the - server.

5 Didn't receive 200 OK from - remote server

This error is generated by the client when a remote server - doesn't return HTTP/1.1 200 OK in response to a request. A more - detailed error report is added onto the end of the phrase - above.

6 No data received from - server

This error is generated by the client when a remote server - returns HTTP/1.1 200 OK in response to a request, but no - response body follows the HTTP headers.

7 No SSL support compiled - in

This error is generated by the client when trying to send - a request with HTTPS and the CURL extension is not available to - PHP.

8 CURL error

This error is generated by the client when trying to send - a request with HTTPS and the HTTPS communication fails.

9-14 multicall - errors

These errors are generated by the server when something - fails inside a system.multicall request.

100- XML parse - errors

Returns 100 plus the XML parser error code for the fault - that occurred. The faultString returned - explains where the parse error was in the incoming XML - stream.

'New style' servers

In the same spirit of simplification that inspired the - xmlrpc_client::return_type class variable, a new - class variable has been added to the server class: - functions_parameters_type. When set to 'phpvals', - the functions registered in the server dispatch map will be called - with plain php values as parameters, instead of a single xmlrpcmsg - instance parameter. The return value of those functions is expected to - be a plain php value, too. An example is worth a thousand - words:


-  function foo($usr_id, $out_lang='en') {
    global $xmlrpcerruser;

    ...

    if ($someErrorCondition)
      return new xmlrpcresp(0, $xmlrpcerruser+1, 'DOH!');
    else
      return array(
        'name' => 'Joe',
        'age' => 27,
        'picture' => new xmlrpcval(file_get_contents($picOfTheGuy), 'base64')
      );
  }

  $s = new xmlrpc_server(
    array(
      "examples.myFunc" => array(
        "function" => "bar::foobar",
        "signature" => array(
          array($xmlrpcString, $xmlrpcInt),
          array($xmlrpcString, $xmlrpcInt, $xmlrpcString)
        )
      )
    ), false);
  $s->functions_parameters_type = 'phpvals';
  $s->service();
-
-

There are a few things to keep in mind when using this - simplified syntax:

to return an xmlrpc error, the method handler function must - return an instance of xmlrpcresp. The only - other way for the server to know when an error response should be - served to the client is to throw an exception and set the server's - exception_handling memeber var to 1;

to return a base64 value, the method handler function must - encode it on its own, creating an instance of an xmlrpcval - object;

the method handler function cannot determine the name of the - xmlrpc method it is serving, unlike standard handler functions that - can retrieve it from the message object;

when receiving nested parameters, the method handler function - has no way to distinguish a php string that was sent as base64 value - from one that was sent as a string value;

this has a direct consequence on the support of - system.multicall: a method whose signature contains datetime or base64 - values will not be available to multicall calls;

last but not least, the direct parsing of xml to php values is - much faster than using xmlrpcvals, and allows the library to handle - much bigger messages without allocating all available server memory or - smashing PHP recursive call stack.

Prev Up Next
xmlrpcresp Home Chapter 8. Global variables
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch08.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch08.html deleted file mode 100644 index c1057ba2..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch08.html +++ /dev/null @@ -1,21 +0,0 @@ - - -Chapter 8. Global variables
Chapter 8. Global variables
Prev   Next

Chapter 8. Global variables

Table of Contents

"Constant" variables
$xmlrpcerruser
$xmlrpcI4, $xmlrpcInt, $xmlrpcBoolean, $xmlrpcDouble, - $xmlrpcString, $xmlrpcDateTime, $xmlrpcBase64, $xmlrpcArray, - $xmlrpcStruct, $xmlrpcValue, $xmlrpcNull
$xmlrpcTypes, $xmlrpc_valid_parents, $xmlrpcerr, $xmlrpcstr, - $xmlrpcerrxml, $xmlrpc_backslash, $_xh, $xml_iso88591_Entities, - $xmlEntities, $xmlrpcs_capabilities
Variables whose value can be modified
xmlrpc_defencoding
xmlrpc_internalencoding
xmlrpcName
xmlrpcVersion
xmlrpc_null_extension
xmlrpc_null_apache_encoding

Many global variables are defined in the xmlrpc.inc file. Some of - those are meant to be used as constants (and modifying their value might - cause unpredictable behaviour), while some others can be modified in your - php scripts to alter the behaviour of the xml-rpc client and - server.

"Constant" variables

$xmlrpcerruser

$xmlrpcerruser = 800;The minimum value for errors reported by user - implemented XML-RPC servers. Error numbers lower than that are - reserved for library usage.

$xmlrpcI4, $xmlrpcInt, $xmlrpcBoolean, $xmlrpcDouble, - $xmlrpcString, $xmlrpcDateTime, $xmlrpcBase64, $xmlrpcArray, - $xmlrpcStruct, $xmlrpcValue, $xmlrpcNull

For convenience the strings representing the XML-RPC types have - been encoded as global variables:


-$xmlrpcI4="i4";
$xmlrpcInt="int";
$xmlrpcBoolean="boolean";
$xmlrpcDouble="double";
$xmlrpcString="string";
$xmlrpcDateTime="dateTime.iso8601";
$xmlrpcBase64="base64";
$xmlrpcArray="array";
$xmlrpcStruct="struct";
$xmlrpcValue="undefined";
$xmlrpcNull="null";
-
-

$xmlrpcTypes, $xmlrpc_valid_parents, $xmlrpcerr, $xmlrpcstr, - $xmlrpcerrxml, $xmlrpc_backslash, $_xh, $xml_iso88591_Entities, - $xmlEntities, $xmlrpcs_capabilities

Reserved for internal usage.

Prev   Next
xmlrpc_server Home Variables whose value can be modified
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch08s02.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch08s02.html deleted file mode 100644 index 964ebf1b..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch08s02.html +++ /dev/null @@ -1,45 +0,0 @@ - - -Variables whose value can be modified
Variables whose value can be modified
Prev Chapter 8. Global variables Next

Variables whose value can be modified

xmlrpc_defencoding

$xmlrpc_defencoding = "UTF8";

This variable defines the character set encoding that will be - used by the xml-rpc client and server to decode the received messages, - when a specific charset declaration is not found (in the messages sent - non-ascii chars are always encoded using character references, so that - the produced xml is valid regardless of the charset encoding - assumed).

Allowed values: "UTF8", - "ISO-8859-1", "ASCII".

Note that the appropriate RFC actually mandates that XML - received over HTTP without indication of charset encoding be treated - as US-ASCII, but many servers and clients 'in the wild' violate the - standard, and assume the default encoding is UTF-8.

xmlrpc_internalencoding

$xmlrpc_internalencoding = "ISO-8859-1";This variable defines the character set encoding - that the library uses to transparently encode into valid XML the - xml-rpc values created by the user and to re-encode the received - xml-rpc values when it passes them to the PHP application. It only - affects xml-rpc values of string type. It is a separate value from - xmlrpc_defencoding, allowing e.g. to send/receive xml messages encoded - on-the-wire in US-ASCII and process them as UTF-8. It defaults to the - character set used internally by PHP (unless you are running an - MBString-enabled installation), so you should change it only in - special situations, if e.g. the string values exchanged in the xml-rpc - messages are directly inserted into / fetched from a database - configured to return UTF8 encoded strings to PHP. Example - usage:


-<?php

include('xmlrpc.inc');
$xmlrpc_internalencoding = 'UTF-8'; // this has to be set after the inclusion above
$v = new xmlrpcval('κόσμε'); // This xmlrpc value will be correctly serialized as the greek word 'kosme'
-
-

xmlrpcName

$xmlrpcName = "XML-RPC for PHP";The string representation of the name of the XML-RPC - for PHP library. It is used by the client for building the User-Agent - HTTP header that is sent with every request to the server. You can - change its value if you need to customize the User-Agent - string.

xmlrpcVersion

$xmlrpcVersion = "2.2";The string representation of the version number of - the XML-RPC for PHP library in use. It is used by the client for - building the User-Agent HTTP header that is sent with every request to - the server. You can change its value if you need to customize the - User-Agent string.

xmlrpc_null_extension

When set to TRUE, the lib will enable - support for the <NIL/> (and <EX:NIL/>) xmlrpc value, as - per the extension to the standard proposed here. This means that - <NIL/> and <EX:NIL/> tags received will be parsed as valid - xmlrpc, and the corresponding xmlrpcvals will return "null" for - scalarTyp().

xmlrpc_null_apache_encoding

When set to TRUE, php NULL values encoded - into xmlrpcval objects get serialized using the - <EX:NIL/> tag instead of - <NIL/>. Please note that both forms are - always accepted as input regardless of the value of this - variable.

Prev Up Next
Chapter 8. Global variables Home Chapter 9. Helper functions
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch09.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch09.html deleted file mode 100644 index e3dc7d1d..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch09.html +++ /dev/null @@ -1,28 +0,0 @@ - - -Chapter 9. Helper functions
Chapter 9. Helper functions
Prev   Next

Chapter 9. Helper functions

Table of Contents

Date functions
iso8601_encode
iso8601_decode
Easy use with nested PHP values
php_xmlrpc_decode
php_xmlrpc_encode
php_xmlrpc_decode_xml
Automatic conversion of php functions into xmlrpc methods (and - vice versa)
wrap_xmlrpc_method
wrap_php_function
Functions removed from the library
xmlrpc_decode
xmlrpc_encode
Debugging aids
xmlrpc_debugmsg

XML-RPC for PHP contains some helper functions which you can use to - make processing of XML-RPC requests easier.

Date functions

The XML-RPC specification has this to say on dates:

Don't assume a timezone. It should be - specified by the server in its documentation what assumptions it makes - about timezones.

Unfortunately, this means that date processing isn't - straightforward. Although XML-RPC uses ISO 8601 format dates, it doesn't - use the timezone specifier.

We strongly recommend that in every case where you pass dates in - XML-RPC calls, you use UTC (GMT) as your timezone. Most computer - languages include routines for handling GMT times natively, and you - won't have to translate between timezones.

For more information about dates, see ISO 8601: The Right - Format for Dates, which has a handy link to a PDF of the ISO - 8601 specification. Note that XML-RPC uses exactly one of the available - representations: CCYYMMDDTHH:MM:SS.

iso8601_encode

stringiso8601_encode(string$time_t,
 int$utc0);
 

Returns an ISO 8601 formatted date generated from the UNIX - timestamp $time_t, as returned by the PHP - function time().

The argument $utc can be omitted, in - which case it defaults to 0. If it is set to - 1, then the function corrects the time passed in - for UTC. Example: if you're in the GMT-6:00 timezone and set - $utc, you will receive a date representation - six hours ahead of your local time.

The included demo program vardemo.php - includes a demonstration of this function.

iso8601_decode

intiso8601_decode(string$isoString,
 int$utc0);
 

Returns a UNIX timestamp from an ISO 8601 encoded time and date - string passed in. If $utc is - 1 then $isoString is assumed - to be in the UTC timezone, and thus the result is also UTC: otherwise, - the timezone is assumed to be your local timezone and you receive a - local timestamp.

Prev   Next
Variables whose value can be modified Home Easy use with nested PHP values
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch09s02.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch09s02.html deleted file mode 100644 index f22372aa..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch09s02.html +++ /dev/null @@ -1,71 +0,0 @@ - - -Easy use with nested PHP values
Easy use with nested PHP values
Prev Chapter 9. Helper functions Next

Easy use with nested PHP values

Dan Libby was kind enough to contribute two helper functions that - make it easier to translate to and from PHP values. This makes it easier - to deal with complex structures. At the moment support is limited to - int, double, string, - array, datetime and struct - datatypes; note also that all PHP arrays are encoded as structs, except - arrays whose keys are integer numbers starting with 0 and incremented by - 1.

These functions reside in xmlrpc.inc.

php_xmlrpc_decode

mixedphp_xmlrpc_decode(xmlrpcval$xmlrpc_val,
 array$options);
 
arrayphp_xmlrpc_decode(xmlrpcmsg$xmlrpcmsg_val,
 string$options);
 

Returns a native PHP value corresponding to the values found in - the xmlrpcval $xmlrpc_val, - translated into PHP types. Base-64 and datetime values are - automatically decoded to strings.

In the second form, returns an array containing the parameters - of the given - xmlrpcmsg_val, decoded - to php types.

The options parameter is optional. If - specified, it must consist of an array of options to be enabled in the - decoding process. At the moment the only valid option are - decode_php_objs and - dates_as_objects. When the first is set, php - objects that have been converted to xml-rpc structs using the - php_xmlrpc_encode function and a corresponding - encoding option will be converted back into object values instead of - arrays (provided that the class definition is available at - reconstruction time). When the second is set, XML-RPC datetime values - will be converted into native dateTime objects - instead of strings.

WARNING: please take - extreme care before enabling the decode_php_objs - option: when php objects are rebuilt from the received xml, their - constructor function will be silently invoked. This means that you are - allowing the remote end to trigger execution of uncontrolled PHP code - on your server, opening the door to code injection exploits. Only - enable this option when you have complete trust of the remote - server/client.

Example:


-// wrapper to expose an existing php function as xmlrpc method handler
function foo_wrapper($m)
{
  $params = php_xmlrpc_decode($m);
  $retval = call_user_func_array('foo', $params);
  return new xmlrpcresp(new xmlrpcval($retval)); // foo return value will be serialized as string
}

$s = new xmlrpc_server(array(
   "examples.myFunc1" => array(
     "function" => "foo_wrapper",
     "signatures" => ...
  )));
-
-

php_xmlrpc_encode

xmlrpcvalphp_xmlrpc_encode(mixed$phpval,
 array$options);
 

Returns an xmlrpcval object populated with the PHP - values in $phpval. Works recursively on arrays - and objects, encoding numerically indexed php arrays into array-type - xmlrpcval objects and non numerically indexed php arrays into - struct-type xmlrpcval objects. Php objects are encoded into - struct-type xmlrpcvals, excepted for php values that are already - instances of the xmlrpcval class or descendants thereof, which will - not be further encoded. Note that there's no support for encoding php - values into base-64 values. Encoding of date-times is optionally - carried on on php strings with the correct format.

The options parameter is optional. If - specified, it must consist of an array of options to be enabled in the - encoding process. At the moment the only valid options are - encode_php_objs, null_extension - and auto_dates.

The first will enable the creation of 'particular' xmlrpcval - objects out of php objects, that add a "php_class" xml attribute to - their serialized representation. This attribute allows the function - php_xmlrpc_decode to rebuild the native php objects (provided that the - same class definition exists on both sides of the communication). The - second allows to encode php NULL values to the - <NIL/> (or - <EX:NIL/>, see ...) tag. The last encodes any - string that matches the ISO8601 format into an XML-RPC - datetime.

Example:


-// the easy way to build a complex xml-rpc struct, showing nested base64 value and datetime values
$val = php_xmlrpc_encode(array(
  'first struct_element: an int' => 666,
  'second: an array' => array ('apple', 'orange', 'banana'),
  'third: a base64 element' => new xmlrpcval('hello world', 'base64'),
  'fourth: a datetime' => '20060107T01:53:00'
  ), array('auto_dates'));
-
-

php_xmlrpc_decode_xml

xmlrpcval | xmlrpcresp | - xmlrpcmsgphp_xmlrpc_decode_xml(string$xml,
 array$options);
 

Decodes the xml representation of either an xmlrpc request, - response or single value, returning the corresponding php-xmlrpc - object, or FALSE in case of an error.

The options parameter is optional. If - specified, it must consist of an array of options to be enabled in the - decoding process. At the moment, no option is supported.

Example:


-$text = '<value><array><data><value>Hello world</value></data></array></value>';
$val = php_xmlrpc_decode_xml($text);
if ($val) echo 'Found a value of type '.$val->kindOf(); else echo 'Found invalid xml';
-
-
Prev Up Next
Chapter 9. Helper functions Home Automatic conversion of php functions into xmlrpc methods (and - vice versa)
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch09s03.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch09s03.html deleted file mode 100644 index 127ee95f..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch09s03.html +++ /dev/null @@ -1,103 +0,0 @@ - - -Automatic conversion of php functions into xmlrpc methods (and vice versa)
Automatic conversion of php functions into xmlrpc methods (and - vice versa)
Prev Chapter 9. Helper functions Next

Automatic conversion of php functions into xmlrpc methods (and - vice versa)

For the extremely lazy coder, helper functions have been added - that allow to convert a php function into an xmlrpc method, and a - remotely exposed xmlrpc method into a local php function - or a set of - methods into a php class. Note that these comes with many caveat.

wrap_xmlrpc_method

stringwrap_xmlrpc_method($client,
 $methodname,
 $extra_options);
 
stringwrap_xmlrpc_method($client,
 $methodname,
 $signum,
 $timeout,
 $protocol,
 $funcname);
 

Given an xmlrpc server and a method name, creates a php wrapper - function that will call the remote method and return results using - native php types for both params and results. The generated php - function will return an xmlrpcresp object for failed xmlrpc - calls.

The second syntax is deprecated, and is listed here only for - backward compatibility.

The server must support the - system.methodSignature xmlrpc method call for - this function to work.

The client param must be a valid - xmlrpc_client object, previously created with the address of the - target xmlrpc server, and to which the preferred communication options - have been set.

The optional parameters can be passed as array key,value pairs - in the extra_options param.

The signum optional param has the purpose - of indicating which method signature to use, if the given server - method has multiple signatures (defaults to 0).

The timeout and - protocol optional params are the same as in the - xmlrpc_client::send() method.

If set, the optional new_function_name - parameter indicates which name should be used for the generated - function. In case it is not set the function name will be - auto-generated.

If the return_source optional parameter is - set, the function will return the php source code to build the wrapper - function, instead of evaluating it (useful to save the code and use it - later as stand-alone xmlrpc client).

If the encode_php_objs optional parameter is - set, instances of php objects later passed as parameters to the newly - created function will receive a 'special' treatment that allows the - server to rebuild them as php objects instead of simple arrays. Note - that this entails using a "slightly augmented" version of the xmlrpc - protocol (ie. using element attributes), which might not be understood - by xmlrpc servers implemented using other libraries.

If the decode_php_objs optional parameter is - set, instances of php objects that have been appropriately encoded by - the server using a coordinate option will be deserialized as php - objects instead of simple arrays (the same class definition should be - present server side and client side).

Note that this might pose a security risk, - since in order to rebuild the object instances their constructor - method has to be invoked, and this means that the remote server can - trigger execution of unforeseen php code on the client: not really a - code injection, but almost. Please enable this option only when you - trust the remote server.

In case of an error during generation of the wrapper function, - FALSE is returned, otherwise the name (or source code) of the new - function.

Known limitations: server must support - system.methodsignature for the wanted xmlrpc - method; for methods that expose multiple signatures, only one can be - picked; for remote calls with nested xmlrpc params, the caller of the - generated php function has to encode on its own the params passed to - the php function if these are structs or arrays whose (sub)members - include values of type base64.

Note: calling the generated php function 'might' be slow: a new - xmlrpc client is created on every invocation and an xmlrpc-connection - opened+closed. An extra 'debug' param is appended to the parameter - list of the generated php function, useful for debugging - purposes.

Example usage:


-$c = new xmlrpc_client('http://phpxmlrpc.sourceforge.net/server.php');

$function = wrap_xmlrpc_method($client, 'examples.getStateName');

if (!$function)
  die('Cannot introspect remote method');
else {
  $stateno = 15;
  $statename = $function($a);
  if (is_a($statename, 'xmlrpcresp')) // call failed
  {
    echo 'Call failed: '.$statename->faultCode().'. Calling again with debug on';
    $function($a, true);
  }
  else
    echo "OK, state nr. $stateno is $statename";
}
-
-

wrap_php_function

arraywrap_php_function(string$funcname,
 string$wrapper_function_name,
 array$extra_options);
 

Given a user-defined PHP function, create a PHP 'wrapper' - function that can be exposed as xmlrpc method from an xmlrpc_server - object and called from remote clients, and return the appropriate - definition to be added to a server's dispatch map.

The optional $wrapper_function_name - specifies the name that will be used for the auto-generated - function.

Since php is a typeless language, to infer types of input and - output parameters, it relies on parsing the javadoc-style comment - block associated with the given function. Usage of xmlrpc native types - (such as datetime.dateTime.iso8601 and base64) in the docblock @param - tag is also allowed, if you need the php function to receive/send data - in that particular format (note that base64 encoding/decoding is - transparently carried out by the lib, while datetime vals are passed - around as strings).

Known limitations: requires PHP 5.0.3 +; only works for - user-defined functions, not for PHP internal functions (reflection - does not support retrieving number/type of params for those); the - wrapped php function will not be able to programmatically return an - xmlrpc error response.

If the return_source optional parameter is - set, the function will return the php source code to build the wrapper - function, instead of evaluating it (useful to save the code and use it - later in a stand-alone xmlrpc server). It will be in the stored in the - source member of the returned array.

If the suppress_warnings optional parameter - is set, any runtime warning generated while processing the - user-defined php function will be catched and not be printed in the - generated xml response.

If the extra_options array contains the - encode_php_objs value, wrapped functions returning - php objects will generate "special" xmlrpc responses: when the xmlrpc - decoding of those responses is carried out by this same lib, using the - appropriate param in php_xmlrpc_decode(), the objects will be - rebuilt.

In short: php objects can be serialized, too (except for their - resource members), using this function. Other libs might choke on the - very same xml that will be generated in this case (i.e. it has a - nonstandard attribute on struct element tags)

If the decode_php_objs optional parameter is - set, instances of php objects that have been appropriately encoded by - the client using a coordinate option will be deserialized and passed - to the user function as php objects instead of simple arrays (the same - class definition should be present server side and client - side).

Note that this might pose a security risk, - since in order to rebuild the object instances their constructor - method has to be invoked, and this means that the remote client can - trigger execution of unforeseen php code on the server: not really a - code injection, but almost. Please enable this option only when you - trust the remote clients.

Example usage:


-<?php /**
* State name from state number decoder. NB: do NOT remove this comment block.
* @param integer $stateno the state number
* @return string the name of the state (or error description)
*/
function findstate($stateno)
{
  global $stateNames;
  if (isset($stateNames[$stateno-1]))
  {
    return $stateNames[$stateno-1];
  }
  else
  {
    return "I don't have a state for the index '" . $stateno . "'";
  }
}

// wrap php function, build xmlrpc server
$methods = array();
$findstate_sig = wrap_php_function('findstate');
if ($findstate_sig)
  $methods['examples.getStateName'] = $findstate_sig;
$srv = new xmlrpc_server($methods);
-
-
Prev Up Next
Easy use with nested PHP values Home Functions removed from the library
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch09s04.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch09s04.html deleted file mode 100644 index bb9b638e..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch09s04.html +++ /dev/null @@ -1,14 +0,0 @@ - - -Functions removed from the library
Functions removed from the library
Prev Chapter 9. Helper functions Next

Functions removed from the library

The following two functions have been deprecated in version 1.1 of - the library, and removed in version 2, in order to avoid conflicts with - the EPI xml-rpc library, which also defines two functions with the same - names.

To ease the transition to the new naming scheme and avoid breaking - existing implementations, the following scheme has been adopted: -

  • If EPI-XMLRPC is not active in the current PHP installation, - the constant XMLRPC_EPI_ENABLED will be set to - '0'

  • If EPI-XMLRPC is active in the current PHP installation, the - constant XMLRPC_EPI_ENABLED will be set to - '1'

The following documentation is kept for historical - reference:

xmlrpc_decode

mixedxmlrpc_decode(xmlrpcval$xmlrpc_val);
 

Alias for php_xmlrpc_decode.

xmlrpc_encode

xmlrpcvalxmlrpc_encode(mixed$phpval);
 

Alias for php_xmlrpc_encode.

Prev Up Next
Automatic conversion of php functions into xmlrpc methods (and - vice versa) Home Debugging aids
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch09s05.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch09s05.html deleted file mode 100644 index fa5bed3b..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch09s05.html +++ /dev/null @@ -1,8 +0,0 @@ - - -Debugging aids
Debugging aids
Prev Chapter 9. Helper functions Next

Debugging aids

xmlrpc_debugmsg

voidxmlrpc_debugmsg(string$debugstring);
 

Sends the contents of $debugstring in XML - comments in the server return payload. If a PHP client has debugging - turned on, the user will be able to see server debug - information.

Use this function in your methods so you can pass back - diagnostic information. It is only available from - xmlrpcs.inc.

Prev Up Next
Functions removed from the library Home Chapter 10. Reserved methods
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch10.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch10.html deleted file mode 100644 index 720acceb..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch10.html +++ /dev/null @@ -1,12 +0,0 @@ - - -Chapter 10. Reserved methods
Chapter 10. Reserved methods
Prev   Next

Chapter 10. Reserved methods

Table of Contents

system.getCapabilities
system.listMethods
system.methodSignature
system.methodHelp
system.multicall

In order to extend the functionality offered by XML-RPC servers - without impacting on the protocol, reserved methods are supported in this - release.

All methods starting with system. are - considered reserved by the server. PHP for XML-RPC itself provides four - special methods, detailed in this chapter.

Note that all server objects will automatically respond to clients - querying these methods, unless the property - allow_system_funcs has been set to - false before calling the - service() method. This might pose a security risk - if the server is exposed to public access, e.g. on the internet.

system.getCapabilities

Prev   Next
Debugging aids Home system.listMethods
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch10s02.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch10s02.html deleted file mode 100644 index e226a738..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch10s02.html +++ /dev/null @@ -1,6 +0,0 @@ - - -system.listMethods
system.listMethods
Prev Chapter 10. Reserved methods Next

system.listMethods

This method may be used to enumerate the methods implemented by - the XML-RPC server.

The system.listMethods method requires no - parameters. It returns an array of strings, each of which is the name of - a method implemented by the server.

Prev Up Next
Chapter 10. Reserved methods Home system.methodSignature
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch10s03.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch10s03.html deleted file mode 100644 index 6f451fd5..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch10s03.html +++ /dev/null @@ -1,19 +0,0 @@ - - -system.methodSignature
system.methodSignature
Prev Chapter 10. Reserved methods Next

system.methodSignature

This method takes one parameter, the name of a method implemented - by the XML-RPC server.

It returns an array of possible signatures for this method. A - signature is an array of types. The first of these types is the return - type of the method, the rest are parameters.

Multiple signatures (i.e. overloading) are permitted: this is the - reason that an array of signatures are returned by this method.

Signatures themselves are restricted to the top level parameters - expected by a method. For instance if a method expects one array of - structs as a parameter, and it returns a string, its signature is simply - "string, array". If it expects three integers, its signature is "string, - int, int, int".

For parameters that can be of more than one type, the "undefined" - string is supported.

If no signature is defined for the method, a not-array value is - returned. Therefore this is the way to test for a non-signature, if - $resp below is the response object from a method - call to system.methodSignature:


-$v = $resp->value();
if ($v->kindOf() != "array") {
  // then the method did not have a signature defined
}
-
-

See the introspect.php demo included in this - distribution for an example of using this method.

Prev Up Next
system.listMethods Home system.methodHelp
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch10s04.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch10s04.html deleted file mode 100644 index fd5607f6..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch10s04.html +++ /dev/null @@ -1,6 +0,0 @@ - - -system.methodHelp
system.methodHelp
Prev Chapter 10. Reserved methods Next

system.methodHelp

This method takes one parameter, the name of a method implemented - by the XML-RPC server.

It returns a documentation string describing the use of that - method. If no such string is available, an empty string is - returned.

The documentation string may contain HTML markup.

Prev Up Next
system.methodSignature Home system.multicall
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch10s05.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch10s05.html deleted file mode 100644 index 55e2e1af..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch10s05.html +++ /dev/null @@ -1,10 +0,0 @@ - - -system.multicall
system.multicall
Prev Chapter 10. Reserved methods Next

system.multicall

This method takes one parameter, an array of 'request' struct - types. Each request struct must contain a - methodName member of type string and a - params member of type array, and corresponds to - the invocation of the corresponding method.

It returns a response of type array, with each value of the array - being either an error struct (containing the faultCode and faultString - members) or the successful response value of the corresponding single - method call.

Prev Up Next
system.methodHelp Home Chapter 11. Examples
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch11.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch11.html deleted file mode 100644 index 923dca6a..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch11.html +++ /dev/null @@ -1,8 +0,0 @@ - - -Chapter 11. Examples
Chapter 11. Examples
Prev   Next

Chapter 11. Examples

Table of Contents

XML-RPC client: state name query
Executing a multicall call

The best examples are to be found in the sample files included with - the distribution. Some are included here.

XML-RPC client: state name query

Code to get the corresponding state name from a number (1-50) from - the demo server available on SourceForge


-  $m = new xmlrpcmsg('examples.getStateName',
    array(new xmlrpcval($HTTP_POST_VARS["stateno"], "int")));
  $c = new xmlrpc_client("/server.php", "phpxmlrpc.sourceforge.net", 80);
  $r = $c->send($m);
  if (!$r->faultCode()) {
      $v = $r->value();
      print "State number " . htmlentities($HTTP_POST_VARS["stateno"]) . " is " .
        htmlentities($v->scalarval()) . "<BR>";
      print "<HR>I got this value back<BR><PRE>" .
        htmlentities($r->serialize()) . "</PRE><HR>\n";
  } else {
      print "Fault <BR>";
      print "Code: " . htmlentities($r->faultCode()) . "<BR>" .
            "Reason: '" . htmlentities($r->faultString()) . "'<BR>";
  }
-
-
Prev   Next
system.multicall Home Executing a multicall call
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch11s02.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch11s02.html deleted file mode 100644 index 7bd5fcc5..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch11s02.html +++ /dev/null @@ -1,3 +0,0 @@ - - -Executing a multicall call
Executing a multicall call
Prev Chapter 11. Examples Next

Executing a multicall call

To be documented...

Prev Up Next
Chapter 11. Examples Home Chapter 12. Frequently Asked Questions
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch12.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch12.html deleted file mode 100644 index 5a700ee2..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch12.html +++ /dev/null @@ -1,20 +0,0 @@ - - -Chapter 12. Frequently Asked Questions
Chapter 12. Frequently Asked Questions
Prev   Next

Chapter 12. Frequently Asked Questions

Table of Contents

How to send custom XML as payload of a method call
Is there any limitation on the size of the requests / responses - that can be successfully sent?
My server (client) returns an error whenever the client (server) - returns accented characters
How to enable long-lasting method calls
My client returns "XML-RPC Fault #2: Invalid return payload: - enable debugging to examine incoming payload": what should I do?
How can I save to a file the xml of the xmlrpc responses received - from servers?
Can I use the ms windows character set?
Does the library support using cookies / http sessions?

How to send custom XML as payload of a method call

Unfortunately, at the time the XML-RPC spec was designed, support - for namespaces in XML was not as ubiquitous as it is now. As a - consequence, no support was provided in the protocol for embedding XML - elements from other namespaces into an xmlrpc request.

To send an XML "chunk" as payload of a method call or response, - two options are available: either send the complete XML block as a - string xmlrpc value, or as a base64 value. Since the '<' character in - string values is encoded as '&lt;' in the xml payload of the method - call, the XML string will not break the surrounding xmlrpc, unless - characters outside of the assumed character set are used. The second - method has the added benefits of working independently of the charset - encoding used for the xml to be transmitted, and preserving exactly - whitespace, whilst incurring in some extra message length and cpu load - (for carrying out the base64 encoding/decoding).

Prev   Next
Executing a multicall call Home Is there any limitation on the size of the requests / responses - that can be successfully sent?
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch12s02.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch12s02.html deleted file mode 100644 index 2452bac1..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch12s02.html +++ /dev/null @@ -1,18 +0,0 @@ - - -Is there any limitation on the size of the requests / responses that can be successfully sent?
Is there any limitation on the size of the requests / responses - that can be successfully sent?
Prev Chapter 12. Frequently Asked Questions Next

Is there any limitation on the size of the requests / responses - that can be successfully sent?

Yes. But I have no hard figure to give; it most likely will depend - on the version of PHP in usage and its configuration.

Keep in mind that this library is not optimized for speed nor for - memory usage. Better alternatives exist when there are strict - requirements on throughput or resource usage, such as the php native - xmlrpc extension (see the PHP manual for more information).

Keep in mind also that HTTP is probably not the best choice in - such a situation, and XML is a deadly enemy. CSV formatted data over - socket would be much more efficient.

If you really need to move a massive amount of data around, and - you are crazy enough to do it using phpxmlrpc, your best bet is to - bypass usage of the xmlrpcval objects, at least in the decoding phase, - and have the server (or client) object return to the calling function - directly php values (see xmlrpc_client::return_type - and xmlrpc_server::functions_parameters_type for more - details).

Prev Up Next
Chapter 12. Frequently Asked Questions Home My server (client) returns an error whenever the client (server) - returns accented characters
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch12s03.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch12s03.html deleted file mode 100644 index 99e2fe2e..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch12s03.html +++ /dev/null @@ -1,6 +0,0 @@ - - -My server (client) returns an error whenever the client (server) returns accented characters
My server (client) returns an error whenever the client (server) - returns accented characters
Prev Chapter 12. Frequently Asked Questions Next

My server (client) returns an error whenever the client (server) - returns accented characters

To be documented...

Prev Up Next
Is there any limitation on the size of the requests / responses - that can be successfully sent? Home How to enable long-lasting method calls
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch12s04.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch12s04.html deleted file mode 100644 index 8bbf337b..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch12s04.html +++ /dev/null @@ -1,5 +0,0 @@ - - -How to enable long-lasting method calls
How to enable long-lasting method calls
Prev Chapter 12. Frequently Asked Questions Next

How to enable long-lasting method calls

To be documented...

Prev Up Next
My server (client) returns an error whenever the client (server) - returns accented characters Home My client returns "XML-RPC Fault #2: Invalid return payload: - enable debugging to examine incoming payload": what should I do?
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch12s05.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch12s05.html deleted file mode 100644 index cd46090f..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch12s05.html +++ /dev/null @@ -1,13 +0,0 @@ - - -My client returns "XML-RPC Fault #2: Invalid return payload: enable debugging to examine incoming payload": what should I do?
My client returns "XML-RPC Fault #2: Invalid return payload: - enable debugging to examine incoming payload": what should I do?
Prev Chapter 12. Frequently Asked Questions Next

My client returns "XML-RPC Fault #2: Invalid return payload: - enable debugging to examine incoming payload": what should I do?

The response you are seeing is a default error response that the - client object returns to the php application when the server did not - respond to the call with a valid xmlrpc response.

The most likely cause is that you are not using the correct URL - when creating the client object, or you do not have appropriate access - rights to the web page you are requesting, or some other common http - misconfiguration.

To find out what the server is really returning to your client, - you have to enable the debug mode of the client, using - $client->setdebug(1);

Prev Up Next
How to enable long-lasting method calls Home How can I save to a file the xml of the xmlrpc responses received - from servers?
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch12s06.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch12s06.html deleted file mode 100644 index 9a1755f8..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch12s06.html +++ /dev/null @@ -1,27 +0,0 @@ - - -How can I save to a file the xml of the xmlrpc responses received from servers?
How can I save to a file the xml of the xmlrpc responses received - from servers?
Prev Chapter 12. Frequently Asked Questions Next

How can I save to a file the xml of the xmlrpc responses received - from servers?

If what you need is to save the responses received from the server - as xml, you have two options:

1- use the serialize() method on the response object.


-$resp = $client->send($msg);
if (!$resp->faultCode())
  $data_to_be_saved = $resp->serialize();
-
-

Note that this will not be 100% accurate, since the xml generated - by the response object can be different from the xml received, - especially if there is some character set conversion involved, or such - (eg. if you receive an empty string tag as <string/>, serialize() - will output <string></string>), or if the server sent back - as response something invalid (in which case the xml generated client - side using serialize() will correspond to the error response generated - internally by the lib).

2 - set the client object to return the raw xml received instead - of the decoded objects:


-$client = new xmlrpc_client($url);
$client->return_type = 'xml';
$resp = $client->send($msg);
if (!$resp->faultCode())
  $data_to_be_saved = $resp->value();
-
-

Note that using this method the xml response response will not be - parsed at all by the library, only the http communication protocol will - be checked. This means that xmlrpc responses sent by the server that - would have generated an error response on the client (eg. malformed xml, - responses that have faultcode set, etc...) now will not be flagged as - invalid, and you might end up saving not valid xml but random - junk...

Prev Up Next
My client returns "XML-RPC Fault #2: Invalid return payload: - enable debugging to examine incoming payload": what should I do? Home Can I use the ms windows character set?
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch12s07.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch12s07.html deleted file mode 100644 index 69c4e347..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch12s07.html +++ /dev/null @@ -1,22 +0,0 @@ - - -Can I use the ms windows character set?
Can I use the ms windows character set?
Prev Chapter 12. Frequently Asked Questions Next

Can I use the ms windows character set?

If the data your application is using comes from a Microsoft - application, there are some chances that the character set used to - encode it is CP1252 (the same might apply to data received from an - external xmlrpc server/client, but it is quite rare to find xmlrpc - toolkits that encode to CP1252 instead of UTF8). It is a character set - which is "almost" compatible with ISO 8859-1, but for a few extra - characters.

PHP-XMLRPC only supports the ISO 8859-1 and UTF8 character sets. - The net result of this situation is that those extra characters will not - be properly encoded, and will be received at the other end of the - XML-RPC tranmission as "garbled data". Unfortunately the library cannot - provide real support for CP1252 because of limitations in the PHP 4 xml - parser. Luckily, we tried our best to support this character set anyway, - and, since version 2.2.1, there is some form of support, left commented - in the code.

To properly encode outgoing data that is natively in CP1252, you - will have to uncomment all relative code in the file - xmlrpc.inc (you can search for the string "1252"), - then set $GLOBALS['xmlrpc_internalencoding']='CP1252'; - Please note that all incoming data will then be fed to your application - as UTF-8 to avoid any potentail data loss.

Prev Up Next
How can I save to a file the xml of the xmlrpc responses received - from servers? Home Does the library support using cookies / http sessions?
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/ch12s08.html b/include/limesurvey/admin/classes/xmlrpc/doc/ch12s08.html deleted file mode 100644 index 241caead..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/ch12s08.html +++ /dev/null @@ -1,13 +0,0 @@ - - -Does the library support using cookies / http sessions?
Does the library support using cookies / http sessions?
Prev Chapter 12. Frequently Asked Questions Next

Does the library support using cookies / http sessions?

In short: yes, but a little coding is needed to make it - happen.

The code below uses sessions to e.g. let the client store a value - on the server and retrieve it later.


-$resp = $client->send(new xmlrpcmsg('registervalue', array(new xmlrpcval('foo'), new xmlrpcval('bar'))));
if (!$resp->faultCode())
{
  $cookies = $resp->cookies();
  if (array_key_exists('PHPSESSID', $cookies)) // nb: make sure to use the correct session cookie name
  {
    $session_id = $cookies['PHPSESSID']['value'];

    // do some other stuff here...

    $client->setcookie('PHPSESSID', $session_id);
    $val = $client->send(new xmlrpcmsg('getvalue', array(new xmlrpcval('foo')));
  }
}
-
-

Server-side sessions are handled normally like in any other - php application. Please see the php manual for more information about - sessions.

NB: unlike web browsers, not all xmlrpc clients support usage of - http cookies. If you have troubles with sessions and control only the - server side of the communication, please check with the makers of the - xmlrpc client in use.

Prev Up Next
Can I use the ms windows character set? Home Appendix A. Integration with the PHP xmlrpc extension
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/index.html b/include/limesurvey/admin/classes/xmlrpc/doc/index.html deleted file mode 100644 index 4cec4c4e..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/index.html +++ /dev/null @@ -1,32 +0,0 @@ - - -XML-RPC for PHP
XML-RPC for PHP
   Next

XML-RPC for PHP

version 3.0.0 beta

Edd Dumbill

Gaetano Giunta

Miles Lott

Justin R. Miller

Andres Salomon

Copyright © 1999,2000,2001 Edd Dumbill, Useful Information Company

All rights reserved.

Redistribution and use in source and binary forms, with or without - modification, are permitted provided that the following conditions are - met:

  • Redistributions of source code must retain the above - copyright notice, this list of conditions and the following - disclaimer.

  • Redistributions in binary form must reproduce the above - copyright notice, this list of conditions and the following - disclaimer in the documentation and/or other materials provided - with the distribution.

  • Neither the name of the "XML-RPC for PHP" nor the names of - its contributors may be used to endorse or promote products - derived from this software without specific prior written - permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND - CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, - BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND - FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED - TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR - PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF - LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING - NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS - SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Table of Contents

1. Introduction
Acknowledgements
2. What's new
3.0.0 beta
2.2.2
2.2.1
2.2
2.1
2.0 final
2.0 Release candidate 3
2.0 Release candidate 2
2.0 Release candidate 1
3. System Requirements
4. Files in the distribution
5. Known bugs and limitations
6. Support
Online Support
The Jellyfish Book
7. Class documentation
xmlrpcval
Notes on types
Creation
Methods
xmlrpcmsg
Creation
Methods
xmlrpc_client
Creation
Methods
Variables
xmlrpcresp
Creation
Methods
xmlrpc_server
Method handler functions
The dispatch map
Method signatures
Delaying the server response
Modifying the server behaviour
Fault reporting
'New style' servers
8. Global variables
"Constant" variables
$xmlrpcerruser
$xmlrpcI4, $xmlrpcInt, $xmlrpcBoolean, $xmlrpcDouble, - $xmlrpcString, $xmlrpcDateTime, $xmlrpcBase64, $xmlrpcArray, - $xmlrpcStruct, $xmlrpcValue, $xmlrpcNull
$xmlrpcTypes, $xmlrpc_valid_parents, $xmlrpcerr, $xmlrpcstr, - $xmlrpcerrxml, $xmlrpc_backslash, $_xh, $xml_iso88591_Entities, - $xmlEntities, $xmlrpcs_capabilities
Variables whose value can be modified
xmlrpc_defencoding
xmlrpc_internalencoding
xmlrpcName
xmlrpcVersion
xmlrpc_null_extension
xmlrpc_null_apache_encoding
9. Helper functions
Date functions
iso8601_encode
iso8601_decode
Easy use with nested PHP values
php_xmlrpc_decode
php_xmlrpc_encode
php_xmlrpc_decode_xml
Automatic conversion of php functions into xmlrpc methods (and - vice versa)
wrap_xmlrpc_method
wrap_php_function
Functions removed from the library
xmlrpc_decode
xmlrpc_encode
Debugging aids
xmlrpc_debugmsg
10. Reserved methods
system.getCapabilities
system.listMethods
system.methodSignature
system.methodHelp
system.multicall
11. Examples
XML-RPC client: state name query
Executing a multicall call
12. Frequently Asked Questions
How to send custom XML as payload of a method call
Is there any limitation on the size of the requests / responses - that can be successfully sent?
My server (client) returns an error whenever the client (server) - returns accented characters
How to enable long-lasting method calls
My client returns "XML-RPC Fault #2: Invalid return payload: - enable debugging to examine incoming payload": what should I do?
How can I save to a file the xml of the xmlrpc responses received - from servers?
Can I use the ms windows character set?
Does the library support using cookies / http sessions?
A. Integration with the PHP xmlrpc extension
B. Substitution of the PHP xmlrpc extension
C. 'Enough of xmlrpcvals!': new style library usage
D. Usage of the debugger
   Next
   Chapter 1. Introduction
diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/xmlrpc_php.pdf b/include/limesurvey/admin/classes/xmlrpc/doc/xmlrpc_php.pdf deleted file mode 100644 index 147026c220eda313ef3ecc6adcdd275a97405c0e..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 270346 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 diff --git a/include/limesurvey/admin/classes/xmlrpc/doc/xmlrpc_php.xml b/include/limesurvey/admin/classes/xmlrpc/doc/xmlrpc_php.xml deleted file mode 100644 index 6f42602c..00000000 --- a/include/limesurvey/admin/classes/xmlrpc/doc/xmlrpc_php.xml +++ /dev/null @@ -1,4254 +0,0 @@ - - - - - - XML-RPC for PHP - - version 3.0.0 beta - - - Sep 5, 2009 - - - - Edd - - Dumbill - - - - Gaetano - - Giunta - - - - Miles - - Lott - - - - Justin R. - - Miller - - - - Andres - - Salomon - - - - - 1999,2000,2001 - - Edd Dumbill, Useful Information Company - - - - All rights reserved. - - Redistribution and use in source and binary forms, with or without - modification, are permitted provided that the following conditions are - met: - - - - Redistributions of source code must retain the above - copyright notice, this list of conditions and the following - disclaimer. - - - - Redistributions in binary form must reproduce the above - copyright notice, this list of conditions and the following - disclaimer in the documentation and/or other materials provided - with the distribution. - - - - Neither the name of the "XML-RPC for PHP" nor the names of - its contributors may be used to endorse or promote products - derived from this software without specific prior written - permission. - - - - THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND - CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, - BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND - FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED - TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR - PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF - LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING - NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS - SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - - - - - Introduction - - XML-RPC is a format devised by Userland Software for achieving - remote procedure call via XML using HTTP as the transport. XML-RPC has its - own web site, www.xmlrpc.com - - This collection of PHP classes provides a framework for writing - XML-RPC clients and servers in PHP. - - Main goals of the project are ease of use, flexibility and - completeness. - - The original author is Edd Dumbill of Useful Information Company. As of the - 1.0 stable release, the project was opened to wider involvement and moved - to SourceForge. - - A list of XML-RPC implementations for other languages such as Perl - and Python can be found on the www.xmlrpc.com site. - - - Acknowledgements - - Daniel E. Baumann - - James Bercegay - - Leon Blackwell - - Stephane Bortzmeyer - - Daniel Convissor - - Geoffrey T. Dairiki - - Stefan Esser - - James Flemer - - Ernst de Haan - - Tom Knight - - Axel Kollmorgen - - Peter Kocks - - Daniel Krippner - - S. Kuip - - A. Lambert - - Frederic Lecointre - - Dan Libby - - Arnaud Limbourg - - Ernest MacDougal Campbell III - - Lukasz Mach - - Kjartan Mannes - - Ben Margolin - - Nicolay Mausz - - Justin Miller - - Jan Pfeifer - - Giancarlo Pinerolo - - Peter Russel - - Jean-Jacques Sarton - - Viliam Simko - - Idan Sofer - - Douglas Squirrel - - Heiko Stübner - - Anatoly Techtonik - - Tommaso Trani - - Eric van der Vlist - - Christian Wenz - - Jim Winstead - - Przemyslaw Wroblewski - - Bruno Zanetti Melotti - - - - - What's new - - Note: not all items the following list have - (yet) been fully documented, and some might not be present in any other - chapter in the manual. To find a more detailed description of new - functions and methods please take a look at the source code of the - library, which is quite thoroughly commented in javadoc-like form. - - - 3.0.0 beta - - This is the first release of the library to only support PHP 5. - Some legacy code has been removed, and support for features such as - exceptions and dateTime objects introduced. - - The "beta" tag is meant to indicate the fact that the refactoring - has been more widespread than in precedent releases and that more - changes are likely to be introduced with time - the library is still - considered to be production quality. - - - - improved: removed all usage of php functions deprecated in - php 5.3, usage of assign-by-ref when creating new objects - etc... - - - - improved: add support for the <ex:nil/> tag used by - the apache library, both in input and output - - - - improved: add support for dateTime - objects in both in php_xmlrpc_encode and as - parameter for constructor of - xmlrpcval - - - - improved: add support for timestamps as parameter for - constructor of xmlrpcval - - - - improved: add option 'dates_as_objects' to - php_xmlrpc_decode to return - dateTime objects for xmlrpc - datetimes - - - - improved: add new method - SetCurlOptions to - xmrlpc_client to allow extra flexibility in - tweaking http config, such as explicitly binding to an ip - address - - - - improved: add new method - SetUserAgent to - xmrlpc_client to to allow having different - user-agent http headers - - - - improved: add a new member variable in server class to allow - fine-tuning of the encoding of returned values when the server is - in 'phpvals' mode - - - - improved: allow servers in 'xmlrpcvals' mode to also - register plain php functions by defining them in the dispatch map - with an added option - - - - improved: catch exceptions thrown during execution of php - functions exposed as methods by the server - - - - fixed: bad encoding if same object is encoded twice using - php_xmlrpc_encode - - - - - - 2.2.2 - - Note: this might the last release of the - library that will support PHP 4. Future releases (if any) should target - php 5.0 as minimum supported version. - - - - fixed: encoding of utf-8 characters outside of the BMP - plane - - - - fixed: character set declarations surrounded by double - quotes were not recognized in http headers - - - - fixed: be more tolerant in detection of charset in http - headers - - - - fixed: fix detection of zlib.output_compression - - - - fixed: use feof() to test if socket connections are to be - closed instead of the number of bytes read (rare bug when - communicating with some servers) - - - - fixed: format floating point values using the correct - decimal separator even when php locale is set to one that uses - comma - - - - fixed: improve robustness of the debugger when parsing weird - results from non-compliant servers - - - - php warning when receiving 'false' in a bool value - - - - improved: allow the add_to_map server method to add docs for - single params too - - - - improved: added the possibility to wrap for exposure as - xmlrpc methods plain php class methods, object methods and even - whole classes - - - - - - 2.2.1 - - - - fixed: work aroung bug in php 5.2.2 which broke support of - HTTP_RAW_POST_DATA - - - - fixed: is_dir parameter of setCaCertificate() method is - reversed - - - - fixed: a php warning in xmlrpc_client creator method - - - - fixed: parsing of '1e+1' as valid float - - - - fixed: allow errorlevel 3 to work when prev. error handler was - a static method - - - - fixed: usage of client::setcookie() for multiple cookies in - non-ssl mode - - - - improved: support for CP1252 charset is not part or the - library but almost possible - - - - improved: more info when curl is enabled and debug mode is - on - - - - - - 2.2 - - - - fixed: debugger errors on php installs with magic_quotes_gpc - on - - - - fixed: support for https connections via proxy - - - - fixed: wrap_xmlrpc_method() generated code failed to properly - encode php objects - - - - improved: slightly faster encoding of data which is internally - UTF-8 - - - - improved: debugger always generates a 'null' id for jsonrpc if - user omits it - - - - new: debugger can take advantage of a graphical value builder - (it has to be downloaded separately, as part of jsxmlrpc package. - See Appendix D for more details) - - - - new: support for the <NIL/> xmlrpc extension. see below - for more details - - - - new: server support for the system.getCapabilities xmlrpc - extension - - - - new: wrap_xmlrpc_method() - accepts two new options: debug and return_on_fault - - - - - - 2.1 - - - - The wrap_php_function and - wrap_xmlrpc_method functions have been moved - out of the base library file xmlrpc.inc into - a file of their own: xmlrpc_wrappers.inc. You - will have to include() / require() it in your scripts if you have - been using those functions. For increased security, the automatic - rebuilding of php object instances out of received xmlrpc structs - in wrap_xmlrpc_method() has been disabled - (but it can be optionally re-enabled). Both - wrap_php_function() and - wrap_xmlrpc_method() functions accept many - more options to fine tune their behaviour, including one to return - the php code to be saved and later used as standalone php - script - - - - The constructor of xmlrpcval() values has seen some internal - changes, and it will not throw a php warning anymore when invoked - using an unknown xmlrpc type: the error will only be written to - php error log. Also new xmlrpcval('true', 'boolean') - is not supported anymore - - - - The new function - php_xmlrpc_decode_xml() will take the xml - representation of either an xmlrpc request, response or single - value and return the corresponding php-xmlrpc object - instance - - - - A new function wrap_xmlrpc_server()has - been added, to wrap all (or some) of the methods exposed by a - remote xmlrpc server into a php class - - - - A new file has been added: - verify_compat.php, to help users diagnose the - level of compliance of their php installation with the - library - - - - Restored compatibility with php 4.0.5 (for those poor souls - still stuck on it) - - - - Method xmlrpc_server->service() - now returns a value: either the response payload or xmlrpcresp - object instance - - - - Method - xmlrpc_server->add_to_map() now - accepts xmlrpc methods with no param definitions - - - - Documentation for single parameters of exposed methods can - be added to the dispatch map (and turned into html docs in - conjunction with a future release of the 'extras' package) - - - - Full response payload is saved into xmlrpcresp object for - further debugging - - - - The debugger can now generate code that wraps a remote - method into a php function (works for jsonrpc, too); it also has - better support for being activated via a single GET call (e.g. for - integration into other tools) - - - - Stricter parsing of incoming xmlrpc messages: two more - invalid cases are now detected (double data - element inside array and - struct/array after scalar - inside value element) - - - - More logging of errors in a lot of situations - - - - Javadoc documentation of lib files (almost) complete - - - - Many performance tweaks and code cleanups, plus the usual - crop of bugs fixed (see NEWS file for complete list of - bugs) - - - - Lib internals have been modified to provide better support - for grafting extra functionality on top of it. Stay tuned for - future releases of the EXTRAS package (or go read Appendix - B)... - - - - - - 2.0 final - - - - Added to the client class the possibility to use Digest and - NTLM authentication methods (when using the CURL library) for - connecting to servers and NTLM for connecting to proxies - - - - Added to the client class the possibility to specify - alternate certificate files/directories for authenticating the - peer with when using HTTPS communication - - - - Reviewed all examples and added a new demo file, containing - a proxy to forward xmlrpc requests to other servers (useful e.g. - for ajax coding) - - - - The debugger has been upgraded to reflect the new client - capabilities - - - - All known bugs have been squashed, and the lib is more - tolerant than ever of commonly-found mistakes - - - - - - 2.0 Release candidate 3 - - - - Added to server class the property - functions_parameters_type, that allows the - server to register plain php functions as xmlrpc methods (i.e. - functions that do not take an xmlrpcmsg object as unique - param) - - - - let server and client objects serialize calls using a - specified character set encoding for the produced xml instead of - US-ASCII (ISO-8859-1 and UTF-8 supported) - - - - let php_xmlrpc_decode accept xmlrpcmsg objects as valid - input - - - - 'class::method' syntax is now accepted in the server - dispatch map - - - - xmlrpc_clent::SetDebug() accepts - integer values instead of a boolean value, with debugging level 2 - adding to the information printed to screen the complete client - request - - - - - - 2.0 Release candidate 2 - - - - Added a new property of the client object: - xmlrpc_client->return_type, indicating whether - calls to the send() method will return xmlrpcresp objects whose - value() is an xmlrpcval object, a php value (automatically - decoded) or the raw xml received from the server. - - - - Added in the extras dir. two new library file: - jsonrpc.inc and - jsonrpcs.inc containing new classes that - implement support for the json-rpc protocol (alpha quality - code) - - - - Added a new client method: setKey($key, - $keypass) to be used in HTTPS connections - - - - Added a new file containing some benchmarks in the testsuite - directory - - - - - - 2.0 Release candidate 1 - - - - Support for HTTP proxies (new method: - xmlrpc_client::setProxy()) - - - - Support HTTP compression of both requests and responses. - Clients can specify what kind of compression they accept for - responses between deflate/gzip/any, and whether to compress the - requests. Servers by default compress responses to clients that - explicitly declare support for compression (new methods: - xmlrpc_client::setAcceptedCompression(), - xmlrpc_client::setRequestCompression()). Note that the - ZLIB php extension needs to be enabled in PHP to support - compression. - - - - Implement HTTP 1.1 connections, but only if CURL is enabled - (added an extra parameter to - xmlrpc_client::xmlrpc_client to set the desired HTTP - protocol at creation time and a new supported value for the last - parameter of xmlrpc_client::send, which now can be - safely omitted if it has been specified at creation time) - - With PHP versions greater than 4.3.8 keep-alives are enabled - by default for HTTP 1.1 connections. This should yield faster - execution times when making multiple calls in sequence to the same - xml-rpc server from a single client. - - - - Introduce support for cookies. Cookies to be sent to the - server with a request can be set using - xmlrpc_client::setCookie(), while cookies received from - the server are found in xmlrpcresp::cookies(). It is - left to the user to check for validity of received cookies and - decide whether they apply to successive calls or not. - - - - Better support for detecting different character set encodings - of xml-rpc requests and responses: both client and server objects - will correctly detect the charset encoding of received xml, and use - an appropriate xml parser. - - Supported encodings are US-ASCII, UTF-8 and ISO-8859-1. - - - - Added one new xmlrpcmsg constructor syntax, allowing usage of - a single string with the complete URL of the target server - - - - Convert xml-rpc boolean values into native php values instead - of 0 and 1 - - - - Force the php_xmlrpc_encode function to properly - encode numerically indexed php arrays into xml-rpc arrays - (numerically indexed php arrays always start with a key of 0 and - increment keys by values of 1) - - - - Prevent the php_xmlrpc_encode function from - further re-encoding any objects of class xmlrpcval that - are passed to it. This allows to call the function with arguments - consisting of mixed php values / xmlrpcval objects. - - - - Allow a server to NOT respond to system.* method calls - (setting the $server->allow_system_funcs - property). - - - - Implement a new xmlrpcval method to determine if a value of - type struct has a member of a given name without having to loop - trough all members: xmlrpcval::structMemExists() - - - - Expand methods xmlrpcval::addArray, - addScalar and addStruct allowing extra php - values to be added to xmlrpcval objects already formed. - - - - Let the xmlrpc_client::send method accept an XML - string for sending instead of an xmlrpcmsg object, to facilitate - debugging and integration with the php native xmlrpc - extension - - - - Extend the php_xmlrpc_encode and - php_xmlrpc_decode functions to allow serialization and - rebuilding of PHP objects. To successfully rebuild a serialized - object, the object class must be defined in the deserializing end of - the transfer. Note that object members of type resource will be - deserialized as NULL values. - - Note that his has been implemented adding a "php_class" - attribute to xml representation of xmlrpcval of STRUCT type, which, - strictly speaking, breaks the xml-rpc spec. Other xmlrpc - implementations are supposed to ignore such an attribute (unless - they implement a brain-dead custom xml parser...), so it should be - safe enabling it in heterogeneous environments. The activation of - this feature is done by usage of an option passed as second - parameter to both php_xmlrpc_encode and - php_xmlrpc_decode. - - - - Extend the php_xmlrpc_encode function to allow - automatic serialization of iso8601-conforming php strings as - datetime.iso8601 xmlrpcvals, by usage of an optional - parameter - - - - Added an automatic stub code generator for converting xmlrpc - methods to php functions and vice-versa. - - This is done via two new functions: - wrap_php_function and wrap_xmlrpc_method, - and has many caveats, with php being a typeless language and - all... - - With PHP versions lesser than 5.0.3 wrapping of php functions - into xmlrpc methods is not supported yet. - - - - Allow object methods to be used in server dispatch map - - - - Added a complete debugger solution, in the - debugger folder - - - - Added configurable server-side debug messages, controlled by - the new method xmlrpc_server::SetDebug(). At level 0, - no debug messages are sent to the client; level 1 is the same as the - old behaviour; at level 2 a lot more info is echoed back to the - client, regarding the received call; at level 3 all warnings raised - during server processing are trapped (this prevents breaking the xml - to be echoed back to the client) and added to the debug info sent - back to the client - - - - New XML parsing code, yields smaller memory footprint and - faster execution times, not to mention complete elimination of the - dreaded eval() construct, so prone to code - injection exploits - - - - Rewritten most of the error messages, making text more - explicative - - - - - - - System Requirements - - The library has been designed with goals of scalability and backward - compatibility. As such, it supports a wide range of PHP installs. Note - that not all features of the lib are available in every - configuration. - - The minimum supported PHP version is - 5.0. - - Automatic generation of xml-rpc methods from php functions is only - supported with PHP version 5.0.3 and later (note that the lib will - generate some warnings with PHP 5 in strict error reporting mode). - - If you wish to use SSL or HTTP 1.1 to communicate with remote - servers, you need the "curl" extension compiled into your PHP - installation. - - The "xmlrpc" native extension is not required to be compiled into - your PHP installation, but if it is, there will be no interference with - the operation of this library. - - - - Files in the distribution - - - - lib/xmlrpc.inc - - - the XML-RPC classes. include() this in - your PHP files to use the classes. - - - - - lib/xmlrpcs.inc - - - the XML-RPC server class. include() this - in addition to xmlrpc.inc to get server functionality - - - - - lib/xmlrpc_wrappers.inc - - - helper functions to "automagically" convert plain php - functions to xmlrpc services and vice versa - - - - - demo/server/proxy.php - - - a sample server implementing xmlrpc proxy - functionality. - - - - - demo/server/server.php - - - a sample server hosting various demo functions, as well as a - full suite of functions used for interoperability testing. It is - used by testsuite.php (see below) for unit testing the library, and - is not to be copied literally into your production servers - - - - - demo/client/client.php, demo/client/agesort.php, - demo/client/which.php - - - client code to exercise some of the functions in server.php, - including the interopEchoTests.whichToolkit - method. - - - - - demo/client/wrap.php - - - client code to illustrate 'wrapping' of remote methods into - php functions. - - - - - demo/client/introspect.php - - - client code to illustrate usage of introspection capabilities - offered by server.php. - - - - - demo/client/mail.php - - - client code to illustrate usage of an xmlrpc-to-email gateway - using Dave Winer's XML-RPC server at userland.com. - - - - - demo/client/zopetest.php - - - example client code that queries an xmlrpc server built in - Zope. - - - - - demo/vardemo.php - - - examples of how to construct xmlrpcval types - - - - - demo/demo1.txt, demo/demo2.txt, demo/demo3.txt - - - XML-RPC responses captured in a file for testing purposes (you - can use these to test the - xmlrpcmsg->parseResponse() method). - - - - - demo/server/discuss.php, - demo/client/comment.php - - - Software used in the PHP chapter of to provide a comment server and allow the - attachment of comments to stories from Meerkat's data store. - - - - - test/testsuite.php, test/parse_args.php - - - A unit test suite for this software package. If you do - development on this software, please consider submitting tests for - this suite. - - - - - test/benchmark.php - - - A (very limited) benchmarking suite for this software package. - If you do development on this software, please consider submitting - benchmarks for this suite. - - - - - test/phpunit.php, test/PHPUnit/*.php - - - An (incomplete) version PEAR's unit test framework for PHP. - The complete package can be found at http://pear.php.net/package/PHPUnit - - - - - test/verify_compat.php - - - Script designed to help the user to verify the level of - compatibility of the library with the current php install - - - - - extras/test.pl, extras/test.py - - - Perl and Python programs to exercise server.php to test that - some of the methods work. - - - - - extras/workspace.testPhpServer.fttb - - - Frontier scripts to exercise the demo server. Thanks to Dave - Winer for permission to include these. See Dave's - announcement of these. - - - - - extras/rsakey.pem - - - A test certificate key for the SSL support, which can be used - to generate dummy certificates. It has the passphrase "test." - - - - - - - Known bugs and limitations - - This started out as a bare framework. Many "nice" bits haven't been - put in yet. Specifically, very little type validation or coercion has been - put in. PHP being a loosely-typed language, this is going to have to be - done explicitly (in other words: you can call a lot of library functions - passing them arguments of the wrong type and receive an error message only - much further down the code, where it will be difficult to - understand). - - dateTime.iso8601 is supported opaquely. It can't be done natively as - the XML-RPC specification explicitly forbids passing of timezone - specifiers in ISO8601 format dates. You can, however, use the and functions - to do the encoding and decoding for you. - - Very little HTTP response checking is performed (e.g. HTTP redirects - are not followed and the Content-Length HTTP header, mandated by the - xml-rpc spec, is not validated); cookie support still involves quite a bit - of coding on the part of the user. - - If a specific character set encoding other than US-ASCII, ISO-8859-1 - or UTF-8 is received in the HTTP header or XML prologue of xml-rpc request - or response messages then it will be ignored for the moment, and the - content will be parsed as if it had been encoded using the charset defined - by - - Support for receiving from servers version 1 cookies (i.e. - conforming to RFC 2965) is quite incomplete, and might cause unforeseen - errors. - - - - Support - - - Online Support - - XML-RPC for PHP is offered "as-is" without any warranty or - commitment to support. However, informal advice and help is available - via the XML-RPC for PHP website and mailing list and from - XML-RPC.com. - - - - The XML-RPC for PHP development is hosted - on phpxmlrpc.sourceforge.net. - Bugs, feature requests and patches can be posted to the project's - website. - - - - The PHP XML-RPC interest mailing list is - run by the author. More details can be - found here. - - - - For more general XML-RPC questions, there is a Yahoo! Groups - XML-RPC mailing - list. - - - - The XML-RPC.com discussion - group is a useful place to get help with using XML-RPC. This group - is also gatewayed into the Yahoo! Groups mailing list. - - - - - - The Jellyfish Book - - Together with Simon St.Laurent and Joe - Johnston, Edd Dumbill wrote a book on XML-RPC for O'Reilly and - Associates on XML-RPC. It features a rather fetching jellyfish on the - cover. - - Complete details of the book are available from - O'Reilly's web site. - - Edd is responsible for the chapter on PHP, which includes a worked - example of creating a forum server, and hooking it up the O'Reilly's - Meerkat service in - order to allow commenting on news stories from around the Web. - - If you've benefited from the effort that has been put into writing - this software, then please consider buying the book! - - - - - Class documentation - - - xmlrpcval - - This is where a lot of the hard work gets done. This class enables - the creation and encapsulation of values for XML-RPC. - - Ensure you've read the XML-RPC spec at http://www.xmlrpc.com/stories/storyReader$7 - before reading on as it will make things clearer. - - The xmlrpcval class can store arbitrarily - complicated values using the following types: i4 int boolean - string double dateTime.iso8601 base64 array struct - null. You should refer to the spec for more information on - what each of these types mean. - - - Notes on types - - - int - - The type i4 is accepted as a synonym - for int when creating xmlrpcval objects. The - xml parsing code will always convert i4 to - int: int is regarded - by this implementation as the canonical name for this type. - - - - base64 - - Base 64 encoding is performed transparently to the caller when - using this type. Decoding is also transparent. Therefore you ought - to consider it as a "binary" data type, for use when you want to - pass data that is not 7-bit clean. - - - - boolean - - The php values true and - 1 map to true. All other - values (including the empty string) are converted to - false. - - - - string - - Characters <, >, ', ", &, are encoded using their - entity reference as &lt; &gt; &apos; &quot; and - &amp; All other characters outside of the ASCII range are - encoded using their character reference representation (e.g. - &#200 for é). The XML-RPC spec recommends only encoding - < & but this implementation goes further, - for reasons explained by the XML 1.0 - recommendation. In particular, using character reference - representation has the advantage of producing XML that is valid - independently of the charset encoding assumed. - - - - null - - There is no support for encoding null - values in the XML-RPC spec, but at least a couple of extensions (and - many toolkits) do support it. Before using null - values in your messages, make sure that the responding party accepts - them, and uses the same encoding convention (see ...). - - - - - Creation - - The constructor is the normal way to create an - xmlrpcval. The constructor can take these - forms: - - - - xmlrpcvalnew - xmlrpcval - - - - - - xmlrpcvalnew - xmlrpcval - - string$stringVal - - - - xmlrpcvalnew - xmlrpcval - - mixed$scalarVal - - string$scalartyp - - - - xmlrpcvalnew - xmlrpcval - - array$arrayVal - - string$arraytyp - - - - The first constructor creates an empty value, which must be - altered using the methods addScalar, - addArray or addStruct before - it can be used. - - The second constructor creates a simple string value. - - The third constructor is used to create a scalar value. The - second parameter must be a name of an XML-RPC type. Valid types are: - "int", "boolean", - "string", "double", - "dateTime.iso8601", "base64" or - "null". - - Examples: - - -$myInt = new xmlrpcvalue(1267, "int"); -$myString = new xmlrpcvalue("Hello, World!", "string"); -$myBool = new xmlrpcvalue(1, "boolean"); -$myString2 = new xmlrpcvalue(1.24, "string"); // note: this will serialize a php float value as xmlrpc string - - - The fourth constructor form can be used to compose complex - XML-RPC values. The first argument is either a simple array in the - case of an XML-RPC array or an associative - array in the case of a struct. The elements of - the array must be xmlrpcval objects - themselves. - - The second parameter must be either "array" - or "struct". - - Examples: - - -$myArray = new xmlrpcval( - array( - new xmlrpcval("Tom"), - new xmlrpcval("Dick"), - new xmlrpcval("Harry") - ), - "array"); - -// recursive struct -$myStruct = new xmlrpcval( - array( - "name" => new xmlrpcval("Tom", "string"), - "age" => new xmlrpcval(34, "int"), - "address" => new xmlrpcval( - array( - "street" => new xmlrpcval("Fifht Ave", "string"), - "city" => new xmlrpcval("NY", "string") - ), - "struct") - ), - "struct"); - - - See the file vardemo.php in this distribution - for more examples. - - - - Methods - - - addScalar - - - - intaddScalar - - string$stringVal - - - - intaddScalar - - mixed$scalarVal - - string$scalartyp - - - - If $val is an empty - xmlrpcval this method makes it a scalar - value, and sets that value. - - If $val is already a scalar value, then - no more scalars can be added and 0 is - returned. - - If $val is an xmlrpcval of type array, - the php value $scalarval is added as its last - element. - - If all went OK, 1 is returned, otherwise - 0. - - - - addArray - - - - intaddArray - - array$arrayVal - - - - The argument is a simple (numerically indexed) array. The - elements of the array must be - xmlrpcval objects - themselves. - - Turns an empty xmlrpcval into an - array with contents as specified by - $arrayVal. - - If $val is an xmlrpcval of type array, - the elements of $arrayVal are appended to the - existing ones. - - See the fourth constructor form for more information. - - If all went OK, 1 is returned, otherwise - 0. - - - - addStruct - - - - intaddStruct - - array$assocArrayVal - - - - The argument is an associative array. The elements of the - array must be xmlrpcval objects - themselves. - - Turns an empty xmlrpcval into a - struct with contents as specified by - $assocArrayVal. - - If $val is an xmlrpcval of type struct, - the elements of $arrayVal are merged with the - existing ones. - - See the fourth constructor form for more information. - - If all went OK, 1 is returned, otherwise - 0. - - - - kindOf - - - - stringkindOf - - - - - - Returns a string containing "struct", "array" or "scalar" - describing the base type of the value. If it returns "undef" it - means that the value hasn't been initialised. - - - - serialize - - - - stringserialize - - - - - - Returns a string containing the XML-RPC representation of this - value. - - - - scalarVal - - - - mixedscalarVal - - - - - - If $val->kindOf() == "scalar", this - method returns the actual PHP-language value of the scalar (base 64 - decoding is automatically handled here). - - - - scalarTyp - - - - stringscalarTyp - - - - - - If $val->kindOf() == "scalar", this - method returns a string denoting the type of the scalar. As - mentioned before, i4 is always coerced to - int. - - - - arrayMem - - - - xmlrpcvalarrayMem - - int$n - - - - If $val->kindOf() == "array", returns - the $nth element in the array represented by - the value $val. The value returned is an - xmlrpcval object. - - -// iterating over values of an array object -for ($i = 0; $i < $val->arraySize(); $i++) -{ - $v = $val->arrayMem($i); - echo "Element $i of the array is of type ".$v->kindOf(); -} - - - - - arraySize - - - - intarraySize - - - - - - If $val is an - array, returns the number of elements in that - array. - - - - structMem - - - - xmlrpcvalstructMem - - string$memberName - - - - If $val->kindOf() == "struct", returns - the element called $memberName from the - struct represented by the value $val. The - value returned is an xmlrpcval object. - - - - structEach - - - - arraystructEach - - - - - - Returns the next (key, value) pair from the struct, when - $val is a struct. - $value is an xmlrpcval itself. See also . - - -// iterating over all values of a struct object -$val->structreset(); -while (list($key, $v) = $val->structEach()) -{ - echo "Element $key of the struct is of type ".$v->kindOf(); -} - - - - - structReset - - - - voidstructReset - - - - - - Resets the internal pointer for - structEach() to the beginning of the struct, - where $val is a struct. - - - - structMemExists - - - - boolstructMemExsists - - string$memberName - - - - Returns TRUE or - FALSE depending on whether a member of the - given name exists in the struct. - - - - - - xmlrpcmsg - - This class provides a representation for a request to an XML-RPC - server. A client sends an xmlrpcmsg to a server, - and receives back an xmlrpcresp (see ). - - - Creation - - The constructor takes the following forms: - - - - xmlrpcmsgnew - xmlrpcmsg - - string$methodName - - array$parameterArraynull - - - - Where methodName is a string indicating - the name of the method you wish to invoke, and - parameterArray is a simple php - Array of xmlrpcval - objects. Here's an example message to the US state - name server: - - -$msg = new xmlrpcmsg("examples.getStateName", array(new xmlrpcval(23, "int"))); - - - This example requests the name of state number 23. For more - information on xmlrpcval objects, see . - - Note that the parameterArray parameter is - optional and can be omitted for methods that take no input parameters - or if you plan to add parameters one by one. - - - - Methods - - - addParam - - - - booladdParam - - xmlrpcval$xmlrpcVal - - - - Adds the xmlrpcval - xmlrpcVal to the parameter list for this - method call. Returns TRUE or FALSE on error. - - - - getNumParams - - - - intgetNumParams - - - - - - Returns the number of parameters attached to this - message. - - - - getParam - - - - xmlrpcvalgetParam - - int$n - - - - Gets the nth parameter in the message - (with the index zero-based). Use this method in server - implementations to retrieve the values sent by the client. - - - - method - - - - stringmethod - - - - - - stringmethod - - string$methName - - - - Gets or sets the method contained in the XML-RPC - message. - - - - parseResponse - - - - xmlrpcrespparseResponse - - string$xmlString - - - - Given an incoming XML-RPC server response contained in the - string $xmlString, this method constructs an - xmlrpcresp response object and returns it, - setting error codes as appropriate (see ). - - This method processes any HTTP/MIME headers it finds. - - - - parseResponseFile - - - - xmlrpcrespparseResponseFile - - file handle - resource$fileHandle - - - - Given an incoming XML-RPC server response on the open file - handle fileHandle, this method reads all the - data it finds and passes it to - parseResponse. - - This method is useful to construct responses from pre-prepared - files (see files demo1.txt, demo2.txt, demo3.txt - in this distribution). It processes any HTTP headers it finds, and - does not close the file handle. - - - - serialize - - - - string - serialize - - - - - - Returns the an XML string representing the XML-RPC - message. - - - - - - xmlrpc_client - - This is the basic class used to represent a client of an XML-RPC - server. - - - Creation - - The constructor accepts one of two possible syntaxes: - - - - xmlrpc_clientnew - xmlrpc_client - - string$server_url - - - - xmlrpc_clientnew - xmlrpc_client - - string$server_path - - string$server_hostname - - int$server_port80 - - string$transport'http' - - - - Here are a couple of usage examples of the first form: - - -$client = new xmlrpc_client("http://phpxmlrpc.sourceforge.net/server.php"); -$another_client = new xmlrpc_client("https://james:bond@secret.service.com:443/xmlrpcserver?agent=007"); - - - The second syntax does not allow to express a username and - password to be used for basic HTTP authorization as in the second - example above, but instead it allows to choose whether xmlrpc calls - will be made using the HTTP 1.0 or 1.1 protocol. - - Here's another example client set up to query Userland's XML-RPC - server at betty.userland.com: - - -$client = new xmlrpc_client("/RPC2", "betty.userland.com", 80); - - - The server_port parameter is optional, - and if omitted will default to 80 when using HTTP and 443 when using - HTTPS (see the method - below). - - The transport parameter is optional, and - if omitted will default to 'http'. Allowed values are either - 'http', 'https' or - 'http11'. Its value can be overridden with every call - to the send method. See the - send method below for more details about the - meaning of the different values. - - - - Methods - - This class supports the following methods. - - - send - - This method takes the forms: - - - - xmlrpcrespsend - - xmlrpcmsg$xmlrpc_message - - int$timeout - - string$transport - - - - arraysend - - array$xmlrpc_messages - - int$timeout - - string$transport - - - - xmlrpcrespsend - - string$xml_payload - - int$timeout - - string$transport - - - - Where xmlrpc_message is an instance of - xmlrpcmsg (see ), - and response is an instance of - xmlrpcresp (see ). - - If xmlrpc_messages is an array of - message instances, responses will be an array of - response instances. The client will try to make use of a single - system.multicall xml-rpc method call to forward to the - server all the messages in a single HTTP round trip, unless - $client->no_multicall has been previously set to - TRUE (see the multicall method below), in which case - many consecutive xmlrpc requests will be sent. - - The third syntax allows to build by hand (or any other means) - a complete xmlrpc request message, and send it to the server. - xml_payload should be a string containing the - complete xml representation of the request. It is e.g. useful when, - for maximal speed of execution, the request is serialized into a - string using the native php xmlrpc functions (see the php manual on - xmlrpc). - - The timeout is optional, and will be - set to 0 (wait for platform-specific predefined - timeout) if omitted. This timeout value is passed to - fsockopen(). It is also used for detecting - server timeouts during communication (i.e. if the server does not - send anything to the client for timeout - seconds, the connection will be closed). - - The transport parameter is optional, - and if omitted will default to the transport set using instance - creator or 'http' if omitted. The only other valid values are - 'https', which will use an SSL HTTP connection to connect to the - remote server, and 'http11'. Note that your PHP must have the "curl" - extension compiled in order to use both these features. Note that - when using SSL you should normally set your port number to 443, - unless the SSL server you are contacting runs at any other - port. - - - PHP 4.0.6 has a bug which prevents SSL working. - - - In addition to low-level errors, the XML-RPC server you were - querying may return an error in the - xmlrpcresp object. See for details of how to handle these - errors. - - - - multiCall - - This method takes the form: - - - - arraymultiCall - - array$messages - - int$timeout - - string$transport - - bool$fallback - - - - This method is used to boxcar many method calls in a single - xml-rpc request. It will try first to make use of the - system.multicall xml-rpc method call, and fall back to - executing many separate requests if the server returns any - error. - - msgs is an array of - xmlrpcmsg objects (see ), and response is an - array of xmlrpcresp objects (see ). - - The timeout and - transport parameters are optional, and behave - as in the send method above. - - The fallback parameter is optional, and - defaults to TRUE. When set to - FALSE it will prevent the client to try using - many single method calls in case of failure of the first multicall - request. It should be set only when the server is known to support - the multicall extension. - - - - setAcceptedCompression - - - - voidsetAcceptedCompression - - string$compressionmethod - - - - This method defines whether the client will accept compressed - xml payload forming the bodies of the xmlrpc responses received from - servers. Note that enabling reception of compressed responses merely - adds some standard http headers to xmlrpc requests. It is up to the - xmlrpc server to return compressed responses when receiving such - requests. Allowed values for - compressionmethod are: 'gzip', 'deflate', - 'any' or null (with any meaning either gzip or deflate). - - This requires the "zlib" extension to be enabled in your php - install. If it is, by default xmlrpc_client - instances will enable reception of compressed content. - - - - setCaCertificate - - - - voidsetCaCertificate - - string$certificate - - bool$is_dir - - - - This method sets an optional certificate to be used in - SSL-enabled communication to validate a remote server with (when the - server_method is set to 'https' in the - client's construction or in the send method and - SetSSLVerifypeer has been set to - TRUE). - - The certificate parameter must be the - filename of a PEM formatted certificate, or a directory containing - multiple certificate files. The is_dir - parameter defaults to FALSE, set it to - TRUE to specify that - certificate indicates a directory instead of - a single file. - - This requires the "curl" extension to be compiled into your - installation of PHP. For more details see the man page for the - curl_setopt function. - - - - setCertificate - - - - voidsetCertificate - - string$certificate - - string$passphrase - - - - This method sets the optional certificate and passphrase used - in SSL-enabled communication with a remote server (when the - server_method is set to 'https' in the - client's construction or in the send method). - - The certificate parameter must be the - filename of a PEM formatted certificate. The - passphrase parameter must contain the - password required to use the certificate. - - This requires the "curl" extension to be compiled into your - installation of PHP. For more details see the man page for the - curl_setopt function. - - Note: to retrieve information about the client certificate on - the server side, you will need to look into the environment - variables which are set up by the webserver. Different webservers - will typically set up different variables. - - - - setCookie - - - - voidsetCookie - - string$name - - string$value - - string$path - - string$domain - - int$port - - - - This method sets a cookie that will be sent to the xmlrpc - server along with every further request (useful e.g. for keeping - session info outside of the xml-rpc payload). - - $value is optional, and defaults to - null. - - $path, $domain and $port are optional, - and will be omitted from the cookie header if unspecified. Note that - setting any of these values will turn the cookie into a 'version 1' - cookie, that might not be fully supported by the server (see RFC2965 - for more details). - - - - setCredentials - - - - voidsetCredentials - - string$username - - string$password - - int$authtype - - - - This method sets the username and password for authorizing the - client to a server. With the default (HTTP) transport, this - information is used for HTTP Basic authorization. Note that username - and password can also be set using the class constructor. With HTTP - 1.1 and HTTPS transport, NTLM and Digest authentication protocols - are also supported. To enable them use the constants - CURLAUTH_DIGEST and - CURLAUTH_NTLM as values for the authtype - parameter. - - - - setCurlOptions - - - - voidsetCurlOptions - - array$options - - This method allows to directly set any desired - option to manipulate the usage of the cURL client (when in cURL - mode). It can be used eg. to explicitly bind to an outgoing ip - address when the server is multihomed - - - - setDebug - - - - voidsetDebug - - int$debugLvl - - - - debugLvl is either 0, - 1 or 2 depending on whether you require the client to - print debugging information to the browser. The default is not to - output this information (0). - - The debugging information at level 1includes the raw data - returned from the XML-RPC server it was querying (including bot HTTP - headers and the full XML payload), and the PHP value the client - attempts to create to represent the value returned by the server. At - level2, the complete payload of the xmlrpc request is also printed, - before being sent t the server. - - This option can be very useful when debugging servers as it - allows you to see exactly what the client sends and the server - returns. - - - - setKey - - - - voidsetKey - - int$key - - int$keypass - - - - This method sets the optional certificate key and passphrase - used in SSL-enabled communication with a remote server (when the - transport is set to 'https' in the client's - construction or in the send method). - - This requires the "curl" extension to be compiled into your - installation of PHP. For more details see the man page for the - curl_setopt function. - - - - setProxy - - - - voidsetProxy - - string$proxyhost - - int$proxyport - - string$proxyusername - - string$proxypassword - - int$authtype - - - - This method enables calling servers via an HTTP proxy. The - proxyusername, - proxypassword and authtype - parameters are optional. Authtype defaults to - CURLAUTH_BASIC (Basic authentication protocol); - the only other valid value is the constant - CURLAUTH_NTLM, and has effect only when the - client uses the HTTP 1.1 protocol. - - NB: CURL versions before 7.11.10 cannot use a proxy to - communicate with https servers. - - - - setRequestCompression - - - - voidsetRequestCompression - - string$compressionmethod - - - - This method defines whether the xml payload forming the - request body will be sent to the server in compressed format, as per - the HTTP specification. This is particularly useful for large - request parameters and over slow network connections. Allowed values - for compressionmethod are: 'gzip', 'deflate', - 'any' or null (with any meaning either gzip or deflate). Note that - there is no automatic fallback mechanism in place for errors due to - servers not supporting receiving compressed request bodies, so make - sure that the particular server you are querying does accept - compressed requests before turning it on. - - This requires the "zlib" extension to be enabled in your php - install. - - - - setSSLVerifyHost - - - - voidsetSSLVerifyHost - - int$i - - - - This method defines whether connections made to XML-RPC - backends via HTTPS should verify the remote host's SSL certificate's - common name (CN). By default, only the existence of a CN is checked. - $i should be an - integer value; 0 to not check the CN at all, 1 to merely check for - its existence, and 2 to check that the CN on the certificate matches - the hostname that is being connected to. - - - - setSSLVerifyPeer - - - - voidsetSSLVerifyPeer - - bool$i - - - - This method defines whether connections made to XML-RPC - backends via HTTPS should verify the remote host's SSL certificate, - and cause the connection to fail if the cert verification fails. - $i should be a boolean - value. Default value: TRUE. To specify custom - SSL certificates to validate the server with, use the - setCaCertificate method. - - - - setUserAgent - - - - voidUseragent - - string$useragent - - This method sets a custom user-agent that will be - used by the client in the http headers sent with the request. The - default value is built using the library name and version - constants. - - - - - Variables - - NB: direct manipulation of these variables is only recommended - for advanced users. - - - no_multicall - - This member variable determines whether the multicall() method - will try to take advantage of the system.multicall xmlrpc method to - dispatch to the server an array of requests in a single http - roundtrip or simply execute many consecutive http calls. Defaults to - FALSE, but it will be enabled automatically on the first failure of - execution of system.multicall. - - - - request_charset_encoding - - This is the charset encoding that will be used for serializing - request sent by the client. - - If defaults to NULL, which means using US-ASCII and encoding - all characters outside of the ASCII range using their xml character - entity representation (this has the benefit that line end characters - will not be mangled in the transfer, a CR-LF will be preserved as - well as a singe LF). - - Valid values are 'US-ASCII', 'UTF-8' and 'ISO-8859-1' - - - - return_type - - This member variable determines whether the value returned - inside an xmlrpcresp object as results of calls to the send() and - multicall() methods will be an xmlrpcval object, a plain php value - or a raw xml string. Allowed values are 'xmlrpcvals' (the default), - 'phpvals' and 'xml'. To allow the user to differentiate between a - correct and a faulty response, fault responses will be returned as - xmlrpcresp objects in any case. Note that the 'phpvals' setting will - yield faster execution times, but some of the information from the - original response will be lost. It will be e.g. impossible to tell - whether a particular php string value was sent by the server as an - xmlrpc string or base64 value. - - Example usage: - - -$client = new xmlrpc_client("phpxmlrpc.sourceforge.net/server"); -$client->return_type = 'phpvals'; -$message = new xmlrpcmsg("examples.getStateName", array(new xmlrpcval(23, "int"))); -$resp = $client->send($message); -if ($resp->faultCode()) echo 'KO. Error: '.$resp->faultString(); else echo 'OK: got '.$resp->value(); - - - For more details about usage of the 'xml' value, see Appendix - A. - - - - - - xmlrpcresp - - This class is used to contain responses to XML-RPC requests. A - server method handler will construct an - xmlrpcresp and pass it as a return value. This - same value will be returned by the result of an invocation of the - send method of the - xmlrpc_client class. - - - Creation - - - - xmlrpcrespnew - xmlrpcresp - - xmlrpcval$xmlrpcval - - - - xmlrpcrespnew - xmlrpcresp - - 0 - - int$errcode - - string$err_string - - - - The first syntax is used when execution has happened without - difficulty: $xmlrpcval is an - xmlrpcval value with the result of the method - execution contained in it. Alternatively it can be a string containing - the xml serialization of the single xml-rpc value result of method - execution. - - The second type of constructor is used in case of failure. - errcode and err_string - are used to provide indication of what has gone wrong. See for more information on passing error - codes. - - - - Methods - - - faultCode - - - - intfaultCode - - - - - - Returns the integer fault code return from the XML-RPC - response. A zero value indicates success, any other value indicates - a failure response. - - - - faultString - - - - stringfaultString - - - - - - Returns the human readable explanation of the fault indicated - by $resp->faultCode(). - - - - value - - - - xmlrpcvalvalue - - - - - - Returns an xmlrpcval object containing - the return value sent by the server. If the response's - faultCode is non-zero then the value returned - by this method should not be used (it may not even be an - object). - - Note: if the xmlrpcresp instance in question has been created - by an xmlrpc_client object whose - return_type was set to 'phpvals', then a plain - php value will be returned instead of an - xmlrpcval object. If the - return_type was set to 'xml', an xml string will - be returned (see the return_type member var above for more - details). - - - - serialize - - - - stringserialize - - - - - - Returns an XML string representation of the response (xml - prologue not included). - - - - - - xmlrpc_server - - The implementation of this class has been kept as simple to use as - possible. The constructor for the server basically does all the work. - Here's a minimal example: - - - function foo ($xmlrpcmsg) { - ... - return new xmlrpcresp($some_xmlrpc_val); - } - - class bar { - function foobar($xmlrpcmsg) { - ... - return new xmlrpcresp($some_xmlrpc_val); - } - } - - $s = new xmlrpc_server( - array( - "examples.myFunc1" => array("function" => "foo"), - "examples.myFunc2" => array("function" => "bar::foobar"), - )); - - - This performs everything you need to do with a server. The single - constructor argument is an associative array from xmlrpc method names to - php function names. The incoming request is parsed and dispatched to the - relevant php function, which is responsible for returning a - xmlrpcresp object, that will be serialized back - to the caller. - - - Method handler functions - - Both php functions and class methods can be registered as xmlrpc - method handlers. - - The synopsis of a method handler function is: - - xmlrpcresp $resp = function (xmlrpcmsg $msg) - - No text should be echoed 'to screen' by the handler function, or - it will break the xml response sent back to the client. This applies - also to error and warning messages that PHP prints to screen unless - the appropriate parameters have been set in the php.in file. Another - way to prevent echoing of errors inside the response and facilitate - debugging is to use the server SetDebug method with debug level 3 (see - ...). Exceptions thrown duting execution of handler functions are - caught by default and a XML-RPC error reponse is generated instead. - This behaviour can be finetuned by usage of the - exception_handling member variable (see - ...). - - Note that if you implement a method with a name prefixed by - system. the handler function will be invoked by the - server with two parameters, the first being the server itself and the - second being the xmlrpcmsg object. - - The same php function can be registered as handler of multiple - xmlrpc methods. - - Here is a more detailed example of what the handler function - foo may do: - - - function foo ($xmlrpcmsg) { - global $xmlrpcerruser; // import user errcode base value - - $meth = $xmlrpcmsg->method(); // retrieve method name - $par = $xmlrpcmsg->getParam(0); // retrieve value of first parameter - assumes at least one param received - $val = $par->scalarval(); // decode value of first parameter - assumes it is a scalar value - - ... - - if ($err) { - // this is an error condition - return new xmlrpcresp(0, $xmlrpcerruser+1, // user error 1 - "There's a problem, Captain"); - } else { - // this is a successful value being returned - return new xmlrpcresp(new xmlrpcval("All's fine!", "string")); - } - } - - - See server.php in this distribution for - more examples of how to do this. - - Since release 2.0RC3 there is a new, even simpler way of - registering php functions with the server. See section 5.7 - below - - - - The dispatch map - - The first argument to the xmlrpc_server - constructor is an array, called the dispatch map. - In this array is the information the server needs to service the - XML-RPC methods you define. - - The dispatch map takes the form of an associative array of - associative arrays: the outer array has one entry for each method, the - key being the method name. The corresponding value is another - associative array, which can have the following members: - - - - function - this - entry is mandatory. It must be either a name of a function in the - global scope which services the XML-RPC method, or an array - containing an instance of an object and a static method name (for - static class methods the 'class::method' syntax is also - supported). - - - - signature - this - entry is an array containing the possible signatures (see ) for the method. If this entry is present - then the server will check that the correct number and type of - parameters have been sent for this method before dispatching - it. - - - - docstring - this - entry is a string containing documentation for the method. The - documentation may contain HTML markup. - - - - signature_docs - this entry can be used - to provide documentation for the single parameters. It must match - in structure the 'signature' member. By default, only the - documenting_xmlrpc_server class in the - extras package will take advantage of this, since the - "system.methodHelp" protocol does not support documenting method - parameters individually. - - - - parameters_type - this entry can be used - when the server is working in 'xmlrpcvals' mode (see ...) to - define one or more entries in the dispatch map as being functions - that follow the 'phpvals' calling convention. The only useful - value is currently the string phpvals. - - - - Look at the server.php example in the - distribution to see what a dispatch map looks like. - - - - Method signatures - - A signature is a description of a method's return type and its - parameter types. A method may have more than one signature. - - Within a server's dispatch map, each method has an array of - possible signatures. Each signature is an array of types. The first - entry is the return type. For instance, the method string examples.getStateName(int) - has the signature array($xmlrpcString, $xmlrpcInt) - and, assuming that it is the only possible signature for the - method, it might be used like this in server creation: -$findstate_sig = array(array($xmlrpcString, $xmlrpcInt)); - -$findstate_doc = 'When passed an integer between 1 and 51 returns the -name of a US state, where the integer is the index of that state name -in an alphabetic order.'; - -$s = new xmlrpc_server( array( - "examples.getStateName" => array( - "function" => "findstate", - "signature" => $findstate_sig, - "docstring" => $findstate_doc - ))); - - - Note that method signatures do not allow to check nested - parameters, e.g. the number, names and types of the members of a - struct param cannot be validated. - - If a method that you want to expose has a definite number of - parameters, but each of those parameters could reasonably be of - multiple types, the array of acceptable signatures will easily grow - into a combinatorial explosion. To avoid such a situation, the lib - defines the global var $xmlrpcValue, which can be - used in method signatures as a placeholder for 'any xmlrpc - type': - - -$echoback_sig = array(array($xmlrpcValue, $xmlrpcValue)); - -$findstate_doc = 'Echoes back to the client the received value, regardless of its type'; - -$s = new xmlrpc_server( array( - "echoBack" => array( - "function" => "echoback", - "signature" => $echoback_sig, // this sig guarantees that the method handler will be called with one and only one parameter - "docstring" => $echoback_doc - ))); - - - Methods system.listMethods, - system.methodHelp, - system.methodSignature and - system.multicall are already defined by the - server, and should not be reimplemented (see Reserved Methods - below). - - - - Delaying the server response - - You may want to construct the server, but for some reason not - fulfill the request immediately (security verification, for instance). - If you omit to pass to the constructor the dispatch map or pass it a - second argument of 0 this will have the desired - effect. You can then use the service() method of - the server class to service the request. For example: - - -$s = new xmlrpc_server($myDispMap, 0); // second parameter = 0 prevents automatic servicing of request - -// ... some code that does other stuff here - -$s->service(); - - - Note that the service method will print - the complete result payload to screen and send appropriate HTTP - headers back to the client, but also return the response object. This - permits further manipulation of the response, possibly in combination - with output buffering. - - To prevent the server from sending HTTP headers back to the - client, you can pass a second parameter with a value of - TRUE to the service - method. In this case, the response payload will be returned instead of - the response object. - - Xmlrpc requests retrieved by other means than HTTP POST bodies - can also be processed. For example: - - -$s = new xmlrpc_server(); // not passing a dispatch map prevents automatic servicing of request - -// ... some code that does other stuff here, including setting dispatch map into server object - -$resp = $s->service($xmlrpc_request_body, true); // parse a variable instead of POST body, retrieve response payload - -// ... some code that does other stuff with xml response $resp here - - - - - Modifying the server behaviour - - A couple of methods / class variables are available to modify - the behaviour of the server. The only way to take advantage of their - existence is by usage of a delayed server response (see above) - - - setDebug() - - This function controls weather the server is going to echo - debugging messages back to the client as comments in response body. - Valid values: 0,1,2,3, with 1 being the default. At level 0, no - debug info is returned to the client. At level 2, the complete - client request is added to the response, as part of the xml - comments. At level 3, a new PHP error handler is set when executing - user functions exposed as server methods, and all non-fatal errors - are trapped and added as comments into the response. - - - - allow_system_funcs - - Default_value: TRUE. When set to FALSE, disables support for - System.xxx functions in the server. It - might be useful e.g. if you do not wish the server to respond to - requests to System.ListMethods. - - - - compress_response - - When set to TRUE, enables the server to take advantage of HTTP - compression, otherwise disables it. Responses will be transparently - compressed, but only when an xmlrpc-client declares its support for - compression in the HTTP headers of the request. - - Note that the ZLIB php extension must be installed for this to - work. If it is, compress_response will default to - TRUE. - - - - exception_handling - - This variable controls the behaviour of the server when an - exception is thrown by a method handler php function. Valid values: - 0,1,2, with 0 being the default. At level 0, the server catches the - exception and return an 'internal error' xmlrpc response; at 1 it - catches the exceptions and return an xmlrpc response with the error - code and error message corresponding to the exception that was - thron; at 2 = the exception is floated to the upper layers in the - code - - - - response_charset_encoding - - Charset encoding to be used for response (only affects string - values). - - If it can, the server will convert the generated response from - internal_encoding to the intended one. - - Valid values are: a supported xml encoding (only UTF-8 and - ISO-8859-1 at present, unless mbstring is enabled), null (leave - charset unspecified in response and convert output stream to - US_ASCII), 'default' (use xmlrpc library default as specified in - xmlrpc.inc, convert output stream if needed), or 'auto' (use - client-specified charset encoding or same as request if request - headers do not specify it (unless request is US-ASCII: then use - library default anyway). - - - - - Fault reporting - - Fault codes for your servers should start at the value indicated - by the global $xmlrpcerruser + 1. - - Standard errors returned by the server include: - - - - 1 Unknown method - - - Returned if the server was asked to dispatch a method it - didn't know about - - - - - 2 Invalid return - payload - - - This error is actually generated by the client, not - server, code, but signifies that a server returned something it - couldn't understand. A more detailed error report is sometimes - added onto the end of the phrase above. - - - - - 3 Incorrect - parameters - - - This error is generated when the server has signature(s) - defined for a method, and the parameters passed by the client do - not match any of signatures. - - - - - 4 Can't introspect: method - unknown - - - This error is generated by the builtin - system.* methods when any kind of - introspection is attempted on a method undefined by the - server. - - - - - 5 Didn't receive 200 OK from - remote server - - - This error is generated by the client when a remote server - doesn't return HTTP/1.1 200 OK in response to a request. A more - detailed error report is added onto the end of the phrase - above. - - - - - 6 No data received from - server - - - This error is generated by the client when a remote server - returns HTTP/1.1 200 OK in response to a request, but no - response body follows the HTTP headers. - - - - - 7 No SSL support compiled - in - - - This error is generated by the client when trying to send - a request with HTTPS and the CURL extension is not available to - PHP. - - - - - 8 CURL error - - - This error is generated by the client when trying to send - a request with HTTPS and the HTTPS communication fails. - - - - - 9-14 multicall - errors - - - These errors are generated by the server when something - fails inside a system.multicall request. - - - - - 100- XML parse - errors - - - Returns 100 plus the XML parser error code for the fault - that occurred. The faultString returned - explains where the parse error was in the incoming XML - stream. - - - - - - - 'New style' servers - - In the same spirit of simplification that inspired the - xmlrpc_client::return_type class variable, a new - class variable has been added to the server class: - functions_parameters_type. When set to 'phpvals', - the functions registered in the server dispatch map will be called - with plain php values as parameters, instead of a single xmlrpcmsg - instance parameter. The return value of those functions is expected to - be a plain php value, too. An example is worth a thousand - words: - function foo($usr_id, $out_lang='en') { - global $xmlrpcerruser; - - ... - - if ($someErrorCondition) - return new xmlrpcresp(0, $xmlrpcerruser+1, 'DOH!'); - else - return array( - 'name' => 'Joe', - 'age' => 27, - 'picture' => new xmlrpcval(file_get_contents($picOfTheGuy), 'base64') - ); - } - - $s = new xmlrpc_server( - array( - "examples.myFunc" => array( - "function" => "bar::foobar", - "signature" => array( - array($xmlrpcString, $xmlrpcInt), - array($xmlrpcString, $xmlrpcInt, $xmlrpcString) - ) - ) - ), false); - $s->functions_parameters_type = 'phpvals'; - $s->service(); -There are a few things to keep in mind when using this - simplified syntax: - - to return an xmlrpc error, the method handler function must - return an instance of xmlrpcresp. The only - other way for the server to know when an error response should be - served to the client is to throw an exception and set the server's - exception_handling memeber var to 1; - - to return a base64 value, the method handler function must - encode it on its own, creating an instance of an xmlrpcval - object; - - the method handler function cannot determine the name of the - xmlrpc method it is serving, unlike standard handler functions that - can retrieve it from the message object; - - when receiving nested parameters, the method handler function - has no way to distinguish a php string that was sent as base64 value - from one that was sent as a string value; - - this has a direct consequence on the support of - system.multicall: a method whose signature contains datetime or base64 - values will not be available to multicall calls; - - last but not least, the direct parsing of xml to php values is - much faster than using xmlrpcvals, and allows the library to handle - much bigger messages without allocating all available server memory or - smashing PHP recursive call stack. - - - - - - Global variables - - Many global variables are defined in the xmlrpc.inc file. Some of - those are meant to be used as constants (and modifying their value might - cause unpredictable behaviour), while some others can be modified in your - php scripts to alter the behaviour of the xml-rpc client and - server. - - - "Constant" variables - - - $xmlrpcerruser - - - $xmlrpcerruser - - 800 - The minimum value for errors reported by user - implemented XML-RPC servers. Error numbers lower than that are - reserved for library usage. - - - - $xmlrpcI4, $xmlrpcInt, $xmlrpcBoolean, $xmlrpcDouble, - $xmlrpcString, $xmlrpcDateTime, $xmlrpcBase64, $xmlrpcArray, - $xmlrpcStruct, $xmlrpcValue, $xmlrpcNull - - For convenience the strings representing the XML-RPC types have - been encoded as global variables: -$xmlrpcI4="i4"; -$xmlrpcInt="int"; -$xmlrpcBoolean="boolean"; -$xmlrpcDouble="double"; -$xmlrpcString="string"; -$xmlrpcDateTime="dateTime.iso8601"; -$xmlrpcBase64="base64"; -$xmlrpcArray="array"; -$xmlrpcStruct="struct"; -$xmlrpcValue="undefined"; -$xmlrpcNull="null"; - - - - - $xmlrpcTypes, $xmlrpc_valid_parents, $xmlrpcerr, $xmlrpcstr, - $xmlrpcerrxml, $xmlrpc_backslash, $_xh, $xml_iso88591_Entities, - $xmlEntities, $xmlrpcs_capabilities - - Reserved for internal usage. - - - - - Variables whose value can be modified - - - xmlrpc_defencoding - - - $xmlrpc_defencoding - - "UTF8" - - - This variable defines the character set encoding that will be - used by the xml-rpc client and server to decode the received messages, - when a specific charset declaration is not found (in the messages sent - non-ascii chars are always encoded using character references, so that - the produced xml is valid regardless of the charset encoding - assumed). - - Allowed values: "UTF8", - "ISO-8859-1", "ASCII". - - Note that the appropriate RFC actually mandates that XML - received over HTTP without indication of charset encoding be treated - as US-ASCII, but many servers and clients 'in the wild' violate the - standard, and assume the default encoding is UTF-8. - - - - xmlrpc_internalencoding - - - $xmlrpc_internalencoding - - "ISO-8859-1" - This variable defines the character set encoding - that the library uses to transparently encode into valid XML the - xml-rpc values created by the user and to re-encode the received - xml-rpc values when it passes them to the PHP application. It only - affects xml-rpc values of string type. It is a separate value from - xmlrpc_defencoding, allowing e.g. to send/receive xml messages encoded - on-the-wire in US-ASCII and process them as UTF-8. It defaults to the - character set used internally by PHP (unless you are running an - MBString-enabled installation), so you should change it only in - special situations, if e.g. the string values exchanged in the xml-rpc - messages are directly inserted into / fetched from a database - configured to return UTF8 encoded strings to PHP. Example - usage: - - -<?php - -include('xmlrpc.inc'); -$xmlrpc_internalencoding = 'UTF-8'; // this has to be set after the inclusion above -$v = new xmlrpcval('κόσμε'); // This xmlrpc value will be correctly serialized as the greek word 'kosme' - - - - - xmlrpcName - - - $xmlrpcName - - "XML-RPC for PHP" - The string representation of the name of the XML-RPC - for PHP library. It is used by the client for building the User-Agent - HTTP header that is sent with every request to the server. You can - change its value if you need to customize the User-Agent - string. - - - - xmlrpcVersion - - - $xmlrpcVersion - - "2.2" - The string representation of the version number of - the XML-RPC for PHP library in use. It is used by the client for - building the User-Agent HTTP header that is sent with every request to - the server. You can change its value if you need to customize the - User-Agent string. - - - - xmlrpc_null_extension - - When set to TRUE, the lib will enable - support for the <NIL/> (and <EX:NIL/>) xmlrpc value, as - per the extension to the standard proposed here. This means that - <NIL/> and <EX:NIL/> tags received will be parsed as valid - xmlrpc, and the corresponding xmlrpcvals will return "null" for - scalarTyp(). - - - - xmlrpc_null_apache_encoding - - When set to TRUE, php NULL values encoded - into xmlrpcval objects get serialized using the - <EX:NIL/> tag instead of - <NIL/>. Please note that both forms are - always accepted as input regardless of the value of this - variable. - - - - - - Helper functions - - XML-RPC for PHP contains some helper functions which you can use to - make processing of XML-RPC requests easier. - - - Date functions - - The XML-RPC specification has this to say on dates: - -
- Don't assume a timezone. It should be - specified by the server in its documentation what assumptions it makes - about timezones. -
- - Unfortunately, this means that date processing isn't - straightforward. Although XML-RPC uses ISO 8601 format dates, it doesn't - use the timezone specifier. - - We strongly recommend that in every case where you pass dates in - XML-RPC calls, you use UTC (GMT) as your timezone. Most computer - languages include routines for handling GMT times natively, and you - won't have to translate between timezones. - - For more information about dates, see ISO 8601: The Right - Format for Dates, which has a handy link to a PDF of the ISO - 8601 specification. Note that XML-RPC uses exactly one of the available - representations: CCYYMMDDTHH:MM:SS. - - - iso8601_encode - - - - stringiso8601_encode - - string$time_t - - int$utc0 - - - - Returns an ISO 8601 formatted date generated from the UNIX - timestamp $time_t, as returned by the PHP - function time(). - - The argument $utc can be omitted, in - which case it defaults to 0. If it is set to - 1, then the function corrects the time passed in - for UTC. Example: if you're in the GMT-6:00 timezone and set - $utc, you will receive a date representation - six hours ahead of your local time. - - The included demo program vardemo.php - includes a demonstration of this function. - - - - iso8601_decode - - - - intiso8601_decode - - string$isoString - - int$utc0 - - - - Returns a UNIX timestamp from an ISO 8601 encoded time and date - string passed in. If $utc is - 1 then $isoString is assumed - to be in the UTC timezone, and thus the result is also UTC: otherwise, - the timezone is assumed to be your local timezone and you receive a - local timestamp. - - - - - Easy use with nested PHP values - - Dan Libby was kind enough to contribute two helper functions that - make it easier to translate to and from PHP values. This makes it easier - to deal with complex structures. At the moment support is limited to - int, double, string, - array, datetime and struct - datatypes; note also that all PHP arrays are encoded as structs, except - arrays whose keys are integer numbers starting with 0 and incremented by - 1. - - These functions reside in xmlrpc.inc. - - - php_xmlrpc_decode - - - - mixedphp_xmlrpc_decode - - xmlrpcval$xmlrpc_val - - array$options - - - - arrayphp_xmlrpc_decode - - xmlrpcmsg$xmlrpcmsg_val - - string$options - - - - Returns a native PHP value corresponding to the values found in - the xmlrpcval $xmlrpc_val, - translated into PHP types. Base-64 and datetime values are - automatically decoded to strings. - - In the second form, returns an array containing the parameters - of the given - xmlrpcmsg_val, decoded - to php types. - - The options parameter is optional. If - specified, it must consist of an array of options to be enabled in the - decoding process. At the moment the only valid option are - decode_php_objs and - dates_as_objects. When the first is set, php - objects that have been converted to xml-rpc structs using the - php_xmlrpc_encode function and a corresponding - encoding option will be converted back into object values instead of - arrays (provided that the class definition is available at - reconstruction time). When the second is set, XML-RPC datetime values - will be converted into native dateTime objects - instead of strings. - - WARNING: please take - extreme care before enabling the decode_php_objs - option: when php objects are rebuilt from the received xml, their - constructor function will be silently invoked. This means that you are - allowing the remote end to trigger execution of uncontrolled PHP code - on your server, opening the door to code injection exploits. Only - enable this option when you have complete trust of the remote - server/client. - - Example: -// wrapper to expose an existing php function as xmlrpc method handler -function foo_wrapper($m) -{ - $params = php_xmlrpc_decode($m); - $retval = call_user_func_array('foo', $params); - return new xmlrpcresp(new xmlrpcval($retval)); // foo return value will be serialized as string -} - -$s = new xmlrpc_server(array( - "examples.myFunc1" => array( - "function" => "foo_wrapper", - "signatures" => ... - ))); - - - - - php_xmlrpc_encode - - - - xmlrpcvalphp_xmlrpc_encode - - mixed$phpval - - array$options - - - - Returns an xmlrpcval object populated with the PHP - values in $phpval. Works recursively on arrays - and objects, encoding numerically indexed php arrays into array-type - xmlrpcval objects and non numerically indexed php arrays into - struct-type xmlrpcval objects. Php objects are encoded into - struct-type xmlrpcvals, excepted for php values that are already - instances of the xmlrpcval class or descendants thereof, which will - not be further encoded. Note that there's no support for encoding php - values into base-64 values. Encoding of date-times is optionally - carried on on php strings with the correct format. - - The options parameter is optional. If - specified, it must consist of an array of options to be enabled in the - encoding process. At the moment the only valid options are - encode_php_objs, null_extension - and auto_dates. - - The first will enable the creation of 'particular' xmlrpcval - objects out of php objects, that add a "php_class" xml attribute to - their serialized representation. This attribute allows the function - php_xmlrpc_decode to rebuild the native php objects (provided that the - same class definition exists on both sides of the communication). The - second allows to encode php NULL values to the - <NIL/> (or - <EX:NIL/>, see ...) tag. The last encodes any - string that matches the ISO8601 format into an XML-RPC - datetime. - - Example: -// the easy way to build a complex xml-rpc struct, showing nested base64 value and datetime values -$val = php_xmlrpc_encode(array( - 'first struct_element: an int' => 666, - 'second: an array' => array ('apple', 'orange', 'banana'), - 'third: a base64 element' => new xmlrpcval('hello world', 'base64'), - 'fourth: a datetime' => '20060107T01:53:00' - ), array('auto_dates')); - - - - - php_xmlrpc_decode_xml - - - - xmlrpcval | xmlrpcresp | - xmlrpcmsgphp_xmlrpc_decode_xml - - string$xml - - array$options - - - - Decodes the xml representation of either an xmlrpc request, - response or single value, returning the corresponding php-xmlrpc - object, or FALSE in case of an error. - - The options parameter is optional. If - specified, it must consist of an array of options to be enabled in the - decoding process. At the moment, no option is supported. - - Example: -$text = '<value><array><data><value>Hello world</value></data></array></value>'; -$val = php_xmlrpc_decode_xml($text); -if ($val) echo 'Found a value of type '.$val->kindOf(); else echo 'Found invalid xml'; - - - - - - Automatic conversion of php functions into xmlrpc methods (and - vice versa) - - For the extremely lazy coder, helper functions have been added - that allow to convert a php function into an xmlrpc method, and a - remotely exposed xmlrpc method into a local php function - or a set of - methods into a php class. Note that these comes with many caveat. - - - wrap_xmlrpc_method - - - - stringwrap_xmlrpc_method - - $client - - $methodname - - $extra_options - - - - stringwrap_xmlrpc_method - - $client - - $methodname - - $signum - - $timeout - - $protocol - - $funcname - - - - Given an xmlrpc server and a method name, creates a php wrapper - function that will call the remote method and return results using - native php types for both params and results. The generated php - function will return an xmlrpcresp object for failed xmlrpc - calls. - - The second syntax is deprecated, and is listed here only for - backward compatibility. - - The server must support the - system.methodSignature xmlrpc method call for - this function to work. - - The client param must be a valid - xmlrpc_client object, previously created with the address of the - target xmlrpc server, and to which the preferred communication options - have been set. - - The optional parameters can be passed as array key,value pairs - in the extra_options param. - - The signum optional param has the purpose - of indicating which method signature to use, if the given server - method has multiple signatures (defaults to 0). - - The timeout and - protocol optional params are the same as in the - xmlrpc_client::send() method. - - If set, the optional new_function_name - parameter indicates which name should be used for the generated - function. In case it is not set the function name will be - auto-generated. - - If the return_source optional parameter is - set, the function will return the php source code to build the wrapper - function, instead of evaluating it (useful to save the code and use it - later as stand-alone xmlrpc client). - - If the encode_php_objs optional parameter is - set, instances of php objects later passed as parameters to the newly - created function will receive a 'special' treatment that allows the - server to rebuild them as php objects instead of simple arrays. Note - that this entails using a "slightly augmented" version of the xmlrpc - protocol (ie. using element attributes), which might not be understood - by xmlrpc servers implemented using other libraries. - - If the decode_php_objs optional parameter is - set, instances of php objects that have been appropriately encoded by - the server using a coordinate option will be deserialized as php - objects instead of simple arrays (the same class definition should be - present server side and client side). - - Note that this might pose a security risk, - since in order to rebuild the object instances their constructor - method has to be invoked, and this means that the remote server can - trigger execution of unforeseen php code on the client: not really a - code injection, but almost. Please enable this option only when you - trust the remote server. - - In case of an error during generation of the wrapper function, - FALSE is returned, otherwise the name (or source code) of the new - function. - - Known limitations: server must support - system.methodsignature for the wanted xmlrpc - method; for methods that expose multiple signatures, only one can be - picked; for remote calls with nested xmlrpc params, the caller of the - generated php function has to encode on its own the params passed to - the php function if these are structs or arrays whose (sub)members - include values of type base64. - - Note: calling the generated php function 'might' be slow: a new - xmlrpc client is created on every invocation and an xmlrpc-connection - opened+closed. An extra 'debug' param is appended to the parameter - list of the generated php function, useful for debugging - purposes. - - Example usage: - - -$c = new xmlrpc_client('http://phpxmlrpc.sourceforge.net/server.php'); - -$function = wrap_xmlrpc_method($client, 'examples.getStateName'); - -if (!$function) - die('Cannot introspect remote method'); -else { - $stateno = 15; - $statename = $function($a); - if (is_a($statename, 'xmlrpcresp')) // call failed - { - echo 'Call failed: '.$statename->faultCode().'. Calling again with debug on'; - $function($a, true); - } - else - echo "OK, state nr. $stateno is $statename"; -} - - - - - wrap_php_function - - - - arraywrap_php_function - - string$funcname - - string$wrapper_function_name - - array$extra_options - - - - Given a user-defined PHP function, create a PHP 'wrapper' - function that can be exposed as xmlrpc method from an xmlrpc_server - object and called from remote clients, and return the appropriate - definition to be added to a server's dispatch map. - - The optional $wrapper_function_name - specifies the name that will be used for the auto-generated - function. - - Since php is a typeless language, to infer types of input and - output parameters, it relies on parsing the javadoc-style comment - block associated with the given function. Usage of xmlrpc native types - (such as datetime.dateTime.iso8601 and base64) in the docblock @param - tag is also allowed, if you need the php function to receive/send data - in that particular format (note that base64 encoding/decoding is - transparently carried out by the lib, while datetime vals are passed - around as strings). - - Known limitations: requires PHP 5.0.3 +; only works for - user-defined functions, not for PHP internal functions (reflection - does not support retrieving number/type of params for those); the - wrapped php function will not be able to programmatically return an - xmlrpc error response. - - If the return_source optional parameter is - set, the function will return the php source code to build the wrapper - function, instead of evaluating it (useful to save the code and use it - later in a stand-alone xmlrpc server). It will be in the stored in the - source member of the returned array. - - If the suppress_warnings optional parameter - is set, any runtime warning generated while processing the - user-defined php function will be catched and not be printed in the - generated xml response. - - If the extra_options array contains the - encode_php_objs value, wrapped functions returning - php objects will generate "special" xmlrpc responses: when the xmlrpc - decoding of those responses is carried out by this same lib, using the - appropriate param in php_xmlrpc_decode(), the objects will be - rebuilt. - - In short: php objects can be serialized, too (except for their - resource members), using this function. Other libs might choke on the - very same xml that will be generated in this case (i.e. it has a - nonstandard attribute on struct element tags) - - If the decode_php_objs optional parameter is - set, instances of php objects that have been appropriately encoded by - the client using a coordinate option will be deserialized and passed - to the user function as php objects instead of simple arrays (the same - class definition should be present server side and client - side). - - Note that this might pose a security risk, - since in order to rebuild the object instances their constructor - method has to be invoked, and this means that the remote client can - trigger execution of unforeseen php code on the server: not really a - code injection, but almost. Please enable this option only when you - trust the remote clients. - - Example usage: - - /** -* State name from state number decoder. NB: do NOT remove this comment block. -* @param integer $stateno the state number -* @return string the name of the state (or error description) -*/ -function findstate($stateno) -{ - global $stateNames; - if (isset($stateNames[$stateno-1])) - { - return $stateNames[$stateno-1]; - } - else - { - return "I don't have a state for the index '" . $stateno . "'"; - } -} - -// wrap php function, build xmlrpc server -$methods = array(); -$findstate_sig = wrap_php_function('findstate'); -if ($findstate_sig) - $methods['examples.getStateName'] = $findstate_sig; -$srv = new xmlrpc_server($methods); - - - - - - Functions removed from the library - - The following two functions have been deprecated in version 1.1 of - the library, and removed in version 2, in order to avoid conflicts with - the EPI xml-rpc library, which also defines two functions with the same - names. - - To ease the transition to the new naming scheme and avoid breaking - existing implementations, the following scheme has been adopted: - - - If EPI-XMLRPC is not active in the current PHP installation, - the constant XMLRPC_EPI_ENABLED will be set to - '0' - - - - If EPI-XMLRPC is active in the current PHP installation, the - constant XMLRPC_EPI_ENABLED will be set to - '1' - - - - The following documentation is kept for historical - reference: - - - xmlrpc_decode - - - - mixedxmlrpc_decode - - xmlrpcval$xmlrpc_val - - - - Alias for php_xmlrpc_decode. - - - - xmlrpc_encode - - - - xmlrpcvalxmlrpc_encode - - mixed$phpval - - - - Alias for php_xmlrpc_encode. - - - - - Debugging aids - - - xmlrpc_debugmsg - - - - voidxmlrpc_debugmsg - - string$debugstring - - - - Sends the contents of $debugstring in XML - comments in the server return payload. If a PHP client has debugging - turned on, the user will be able to see server debug - information. - - Use this function in your methods so you can pass back - diagnostic information. It is only available from - xmlrpcs.inc. - - - - - - Reserved methods - - In order to extend the functionality offered by XML-RPC servers - without impacting on the protocol, reserved methods are supported in this - release. - - All methods starting with system. are - considered reserved by the server. PHP for XML-RPC itself provides four - special methods, detailed in this chapter. - - Note that all server objects will automatically respond to clients - querying these methods, unless the property - allow_system_funcs has been set to - false before calling the - service() method. This might pose a security risk - if the server is exposed to public access, e.g. on the internet. - - - system.getCapabilities - - - - - - system.listMethods - - This method may be used to enumerate the methods implemented by - the XML-RPC server. - - The system.listMethods method requires no - parameters. It returns an array of strings, each of which is the name of - a method implemented by the server. - - - - system.methodSignature - - This method takes one parameter, the name of a method implemented - by the XML-RPC server. - - It returns an array of possible signatures for this method. A - signature is an array of types. The first of these types is the return - type of the method, the rest are parameters. - - Multiple signatures (i.e. overloading) are permitted: this is the - reason that an array of signatures are returned by this method. - - Signatures themselves are restricted to the top level parameters - expected by a method. For instance if a method expects one array of - structs as a parameter, and it returns a string, its signature is simply - "string, array". If it expects three integers, its signature is "string, - int, int, int". - - For parameters that can be of more than one type, the "undefined" - string is supported. - - If no signature is defined for the method, a not-array value is - returned. Therefore this is the way to test for a non-signature, if - $resp below is the response object from a method - call to system.methodSignature: - - -$v = $resp->value(); -if ($v->kindOf() != "array") { - // then the method did not have a signature defined -} - - - See the introspect.php demo included in this - distribution for an example of using this method. - - - - system.methodHelp - - This method takes one parameter, the name of a method implemented - by the XML-RPC server. - - It returns a documentation string describing the use of that - method. If no such string is available, an empty string is - returned. - - The documentation string may contain HTML markup. - - - - system.multicall - - This method takes one parameter, an array of 'request' struct - types. Each request struct must contain a - methodName member of type string and a - params member of type array, and corresponds to - the invocation of the corresponding method. - - It returns a response of type array, with each value of the array - being either an error struct (containing the faultCode and faultString - members) or the successful response value of the corresponding single - method call. - - - - - Examples - - The best examples are to be found in the sample files included with - the distribution. Some are included here. - - - XML-RPC client: state name query - - Code to get the corresponding state name from a number (1-50) from - the demo server available on SourceForge - - - $m = new xmlrpcmsg('examples.getStateName', - array(new xmlrpcval($HTTP_POST_VARS["stateno"], "int"))); - $c = new xmlrpc_client("/server.php", "phpxmlrpc.sourceforge.net", 80); - $r = $c->send($m); - if (!$r->faultCode()) { - $v = $r->value(); - print "State number " . htmlentities($HTTP_POST_VARS["stateno"]) . " is " . - htmlentities($v->scalarval()) . "<BR>"; - print "<HR>I got this value back<BR><PRE>" . - htmlentities($r->serialize()) . "</PRE><HR>\n"; - } else { - print "Fault <BR>"; - print "Code: " . htmlentities($r->faultCode()) . "<BR>" . - "Reason: '" . htmlentities($r->faultString()) . "'<BR>"; - } - - - - - Executing a multicall call - - To be documented... - - - - - Frequently Asked Questions - - - How to send custom XML as payload of a method call - - Unfortunately, at the time the XML-RPC spec was designed, support - for namespaces in XML was not as ubiquitous as it is now. As a - consequence, no support was provided in the protocol for embedding XML - elements from other namespaces into an xmlrpc request. - - To send an XML "chunk" as payload of a method call or response, - two options are available: either send the complete XML block as a - string xmlrpc value, or as a base64 value. Since the '<' character in - string values is encoded as '&lt;' in the xml payload of the method - call, the XML string will not break the surrounding xmlrpc, unless - characters outside of the assumed character set are used. The second - method has the added benefits of working independently of the charset - encoding used for the xml to be transmitted, and preserving exactly - whitespace, whilst incurring in some extra message length and cpu load - (for carrying out the base64 encoding/decoding). - - - - Is there any limitation on the size of the requests / responses - that can be successfully sent? - - Yes. But I have no hard figure to give; it most likely will depend - on the version of PHP in usage and its configuration. - - Keep in mind that this library is not optimized for speed nor for - memory usage. Better alternatives exist when there are strict - requirements on throughput or resource usage, such as the php native - xmlrpc extension (see the PHP manual for more information). - - Keep in mind also that HTTP is probably not the best choice in - such a situation, and XML is a deadly enemy. CSV formatted data over - socket would be much more efficient. - - If you really need to move a massive amount of data around, and - you are crazy enough to do it using phpxmlrpc, your best bet is to - bypass usage of the xmlrpcval objects, at least in the decoding phase, - and have the server (or client) object return to the calling function - directly php values (see xmlrpc_client::return_type - and xmlrpc_server::functions_parameters_type for more - details). - - - - My server (client) returns an error whenever the client (server) - returns accented characters - - To be documented... - - - - How to enable long-lasting method calls - - To be documented... - - - - My client returns "XML-RPC Fault #2: Invalid return payload: - enable debugging to examine incoming payload": what should I do? - - The response you are seeing is a default error response that the - client object returns to the php application when the server did not - respond to the call with a valid xmlrpc response. - - The most likely cause is that you are not using the correct URL - when creating the client object, or you do not have appropriate access - rights to the web page you are requesting, or some other common http - misconfiguration. - - To find out what the server is really returning to your client, - you have to enable the debug mode of the client, using - $client->setdebug(1); - - - - How can I save to a file the xml of the xmlrpc responses received - from servers? - - If what you need is to save the responses received from the server - as xml, you have two options: - - 1- use the serialize() method on the response object. - - -$resp = $client->send($msg); -if (!$resp->faultCode()) - $data_to_be_saved = $resp->serialize(); - - - Note that this will not be 100% accurate, since the xml generated - by the response object can be different from the xml received, - especially if there is some character set conversion involved, or such - (eg. if you receive an empty string tag as <string/>, serialize() - will output <string></string>), or if the server sent back - as response something invalid (in which case the xml generated client - side using serialize() will correspond to the error response generated - internally by the lib). - - 2 - set the client object to return the raw xml received instead - of the decoded objects: - - -$client = new xmlrpc_client($url); -$client->return_type = 'xml'; -$resp = $client->send($msg); -if (!$resp->faultCode()) - $data_to_be_saved = $resp->value(); - - - Note that using this method the xml response response will not be - parsed at all by the library, only the http communication protocol will - be checked. This means that xmlrpc responses sent by the server that - would have generated an error response on the client (eg. malformed xml, - responses that have faultcode set, etc...) now will not be flagged as - invalid, and you might end up saving not valid xml but random - junk... - - - - Can I use the ms windows character set? - - If the data your application is using comes from a Microsoft - application, there are some chances that the character set used to - encode it is CP1252 (the same might apply to data received from an - external xmlrpc server/client, but it is quite rare to find xmlrpc - toolkits that encode to CP1252 instead of UTF8). It is a character set - which is "almost" compatible with ISO 8859-1, but for a few extra - characters. - - PHP-XMLRPC only supports the ISO 8859-1 and UTF8 character sets. - The net result of this situation is that those extra characters will not - be properly encoded, and will be received at the other end of the - XML-RPC tranmission as "garbled data". Unfortunately the library cannot - provide real support for CP1252 because of limitations in the PHP 4 xml - parser. Luckily, we tried our best to support this character set anyway, - and, since version 2.2.1, there is some form of support, left commented - in the code. - - To properly encode outgoing data that is natively in CP1252, you - will have to uncomment all relative code in the file - xmlrpc.inc (you can search for the string "1252"), - then set $GLOBALS['xmlrpc_internalencoding']='CP1252'; - Please note that all incoming data will then be fed to your application - as UTF-8 to avoid any potentail data loss. - - - - Does the library support using cookies / http sessions? - - In short: yes, but a little coding is needed to make it - happen. - - The code below uses sessions to e.g. let the client store a value - on the server and retrieve it later. - - -$resp = $client->send(new xmlrpcmsg('registervalue', array(new xmlrpcval('foo'), new xmlrpcval('bar')))); -if (!$resp->faultCode()) -{ - $cookies = $resp->cookies(); - if (array_key_exists('PHPSESSID', $cookies)) // nb: make sure to use the correct session cookie name - { - $session_id = $cookies['PHPSESSID']['value']; - - // do some other stuff here... - - $client->setcookie('PHPSESSID', $session_id); - $val = $client->send(new xmlrpcmsg('getvalue', array(new xmlrpcval('foo'))); - } -} -Server-side sessions are handled normally like in any other - php application. Please see the php manual for more information about - sessions. - - NB: unlike web browsers, not all xmlrpc clients support usage of - http cookies. If you have troubles with sessions and control only the - server side of the communication, please check with the makers of the - xmlrpc client in use. - - - - - Integration with the PHP xmlrpc extension - - To be documented more... - - In short: for the fastest execution possible, you can enable the php - native xmlrpc extension, and use it in conjunction with phpxmlrpc. The - following code snippet gives an example of such integration - - -/*** client side ***/ -$c = new xmlrpc_client('http://phpxmlrpc.sourceforge.net/server.php'); - -// tell the client to return raw xml as response value -$c->return_type = 'xml'; - -// let the native xmlrpc extension take care of encoding request parameters -$r = $c->send(xmlrpc_encode_request('examples.getStateName', $_POST['stateno'])); - -if ($r->faultCode()) - // HTTP transport error - echo 'Got error '.$r->faultCode(); -else -{ - // HTTP request OK, but XML returned from server not parsed yet - $v = xmlrpc_decode($r->value()); - // check if we got a valid xmlrpc response from server - if ($v === NULL) - echo 'Got invalid response'; - else - // check if server sent a fault response - if (xmlrpc_is_fault($v)) - echo 'Got xmlrpc fault '.$v['faultCode']; - else - echo'Got response: '.htmlentities($v); -} - - - - - Substitution of the PHP xmlrpc extension - - Yet another interesting situation is when you are using a ready-made - php application, that provides support for the XMLRPC protocol via the - native php xmlrpc extension, but the extension is not available on your - php install (e.g. because of shared hosting constraints). - - Since version 2.1, the PHP-XMLRPC library provides a compatibility - layer that aims to be 100% compliant with the xmlrpc extension API. This - means that any code written to run on the extension should obtain the - exact same results, albeit using more resources and a longer processing - time, using the PHP-XMLRPC library and the extension compatibility module. - The module is part of the EXTRAS package, available as a separate download - from the sourceforge.net website, since version 0.2 - - - - 'Enough of xmlrpcvals!': new style library usage - - To be documented... - - In the meantime, see docs about xmlrpc_client::return_type and - xmlrpc_server::functions_parameters_types, as well as php_xmlrpc_encode, - php_xmlrpc_decode and php_xmlrpc_decode_xml - - - - Usage of the debugger - - A webservice debugger is included in the library to help during - development and testing. - - The interface should be self-explicative enough to need little - documentation. - - - - The most useful feature of the debugger is without doubt the "Show - debug info" option. It allows to have a screen dump of the complete http - communication between client and server, including the http headers as - well as the request and response payloads, and is invaluable when - troubleshooting problems with charset encoding, authentication or http - compression. - - The debugger can take advantage of the JSONRPC library extension, to - allow debugging of JSON-RPC webservices, and of the JS-XMLRPC library - visual editor to allow easy mouse-driven construction of the payload for - remote methods. Both components have to be downloaded separately from the - sourceforge.net web pages and copied to the debugger directory to enable - the extra functionality: - - - - to enable jsonrpc functionality, download the PHP-XMLRPC - EXTRAS package, and copy the file jsonrpc.inc - either to the same directory as the debugger or somewhere in your - php include path - - - - to enable the visual value editing dialog, download the - JS-XMLRPC library, and copy somewhere in the web root files - visualeditor.php, - visualeditor.css and the folders - yui and img. Then edit the - debugger file controller.php and set - appropriately the variable $editorpath. - - - - -