Download the PHP package seunmatt/fstackapi_php without Composer

fstackapi_php

This is a convenient PHP wrapper for Formstack's REST API v2. Compatible with Laravel.

Remember to star and watch for changes

Installation

composer require seunmatt/fstackapi_php

Laravel

After installing the dependency. Add the service provider in config/app.php

Run php artisan vendor:publish to publish the config file. The config file is formstack.php and will be in the laravel config folder. Set your access_token in the config file and proceed.

Usage

The package is built around FormStack REST API (v2), thus it is organized in a very simple and flexible way to use. It has different classes that model the elements of Formstack API.

API Response

Every JSON API Response is decoded into an assoc array and returned to the caller.

Configuration

• If you are using this package in Laravel, just run php artisan vendor:publish to publish the config file formstack.php. As usual, it will be located in the config folder.

In the config file, provide your value for access_token.
The base_url by default is set to that of API v2.

• If you clone the repo or are using it outside of laravel then, create a formstack.php at the root dir of the package with the following content:

• Finally, you can put access_token in the environment for use. In which case, the default base_url will be used.

  The ConfigHelper class will read the configuration first from the env, then try the Laravel config helper, and finally try the config file in root dir of package.

FormStack Object Instantiation

Create an instance of the Formstack object you want to work with and then you can call the methods on the instance:

If you don't want to use the config file, You can pass the $token and $baseUrl parameter to the Formstack objects during instantiation:

Example

• Working with forms

• Working with Fields

• Working with Submissions

Submitting a form is straightforward but can be tricky. First get the id for all the fields of the form you want to submit to. You can do this with the FSField object (as shown above) and store the response somewhere you can reference them later.

Then you can proceed to build your data arrray and submit the form as demonstrated below.

• Working with Folders

Exceptions

You can wrap the method calls in a try...catch block to catch:

• GuzzleHttp\Exception\RequestException
• FSExceptions\FSException

All exceptions to API calls are caught by GuzzleHttp\Exception\RequestException

Tests

PHPUnit is used for testing and the test files are located in tests dir. If you fork/clone the repo and will like to run the tests.

First, ensure you have set up the config as specified above, then run the following command from the root dir of the package to run the tests.

It will be a good idea to have an access_token to an account that has not reach its limit for number of forms creation.

API Components Not Covered

• Partial Submissions
• Confirmation Emails
• Notification Emails
• Webhooks

Reference

Formstack API v2 docs: https://developers.formstack.com/docs/api-overview

Contributors

Seun Matt: on twitter @SeunMatt2

Contributing

READ ABOUT CONTRIBUTING HERE

LICENSE

MIT