Download the PHP package uwmadison_doit/caos-php-client without Composer
On this page you can find all versions of the php package uwmadison_doit/caos-php-client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download uwmadison_doit/caos-php-client
More information about uwmadison_doit/caos-php-client
Files in uwmadison_doit/caos-php-client
Package caos-php-client
Short Description A PHP client used to connect with the CAOS API and perform requests
License Apache-2.0
Homepage https://wiki.doit.wisc.edu/confluence/pages/viewpage.action?pageId=47562009
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package caos-php-client
PHP Client for the CAOS API
CAOS
CAOS stands for the Curricular and Academic Operational Data Store. It is used to connect with the PeopleSoft database in order to retrieve various curricular and academic data concerning UW-Madison. Credentials for using CAOS are given on a service by service basis. If you wish to use this client, you must first request credentials on the site found above for your particular project.
CAOS documentation can be found here. Be aware that the docs found here are for the most recent version of CAOS. If you need to reference earlier docs click on the tab Previous Versions.
For more documentation see the section Documentation below.
How to include caos-php-client
The version of the client is tied to the version of the CAOS API. Specifically, the major and minor version numbers align with the CAOS API. For example, version 1.5.x corresponds to the client that uses version 1.5 of the CAOS API whereas version 1.3.x corresponds to the client that uses version 1.3 of the CAOS API.
Installing with composer
If you are using composer to include your dependencies, you can use these instructions as guidelines.
Include uwmadison_doit/caos-php-client in your composer.json file under the section dependencies. Refer to the composer.json guide if you need help.
Composer will create a directory /vendor wherever you have placed your composer.json file. Under this directory you can find the source code for the client and also the autoload.php file.
Place this line at the beginning of the file and you are ready to use the client!
Installing manually
You can install the code directly from GitHub into your project by using the command
Once the source code is installed, you need only to require the autoload.php file under /caos-php-client/src/main. This can be done with this line of code placed at the beginning of your file.
How to issue requests with the client
All requests and responses are handled by the class ChubService which extends php's SoapClient. To use SoapClient you must either configure php with the option --enable-soap or include extension=php_soap.dll in your php.ini file.
Issuing requests with the CAOS API follows this framework.
- Initialize the ChubService by declaring a new instantiation of the class.
- Create a request object concerning the particular data wanted.
- Issue the request using the ChubService's built-in methods.
- Repeat steps 2 and 3 to retrieve all the data desired.
Here is some example code for version 1.5 of the CAOS API.
Documentation
The code used by the CAOS API client is auto generated from a wsdl file which has little documentation. It would be best to compare the description of methods and classes in the JavaDocs to the usage in the PHPDocs. The docs listed below are all specific to version 1.5 of the CAOS API. For earlier versions refer here and click on the tab previous versions.
Request and Response Classes
From the example code above, it should be gleaned that all interactions with the CAOS service must be initiated through an instantiation of the class ChubService. A list of all the function names that can be called by ChubService can be found here in the JavaDocs and link to phpdoc page in the PHPDocs. The names of the functions are correct in the JavaDocs, however the parameters and return values are incorrect.
There are two major types of classes used when interacting with the CAOS API.
-
A request class. This type of class wraps up the parameters needed by a ChubService method call. For example, when calling
$ChubService->GetClass()instead of passing a unique class id, you would pass the object\GetClassRequestwhich contains the unique class id. Many request classes support multiple fields relevant to a query. - A response class. This type of class is returned by a ChubService method call. These classes are wrappers for data actually requested. For instance, a
\GetSubjectResponsecontains the property$subjectwhich is the type\subjectType.
You can refer to the request and response classes here in the JavaDocs and also link to phpdoc page.
Curricular and Academic Data
Once you have retrieved your response using the ChubService methods, you only need to extract the data. The curricular and academic objects (like term, class, advisors, etc.) can be referred to here for curricular and here for academic in the JavaDocs and links to phpdocs here. Remember, usage will always follow the PHPDocs!
Links to php docs coming soon!
Contributing
See CONTRIBUTING if you'd like to contribute to development of this project.
