Download the PHP package koala-labs/pouch without Composer

On this page you can find all versions of the php package koala-labs/pouch. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

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 PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • 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.
Please rate this library. Is it a good library?

Informations about the package pouch

Koala Pouch

Koala Pouch is a fork of Fuzz Production's Magic Box

Koala Pouch has two goals:
  1. To create a two-way interchange format, so that the JSON representations of models broadcast by APIs can be re-applied back to their originating models for updating existing resources and creating new resources.
  2. Provide an interface for API clients to request exactly the data they want in the way they want.

Installation/Setup

  1. composer require koala/pouch
  2. Use or extend Koala\Pouch\Middleware\RepositoryMiddleware into your project and register your class under the $routeMiddleware array in app/Http/Kernel.php. RepositoryMiddleware contains a variety of configuration options that can be overridden
  3. If you're using fuzz/api-server, you can use magical routing by updating app/Providers/RouteServiceProvider.php, RouteServiceProvider@map, to include:

  4. Set up your Pouch resource routes under the middleware key you assign to your chosen RepositoryMiddleware class
  5. Set up a YourAppNamespace\Http\Controllers\ResourceController, here is what a ResourceController might look like .
  6. Set up models according to Model Setup section

Testing

Just run phpunit after you composer install.

Eloquent Repository

Koala\Pouch\EloquentRepository implements a CRUD repository that cascades through relationships, whether or not related models have been created yet.

Consider a simple model where a User has many Posts. EloquentRepository's basic usage is as follows:

Create a User with the username Steve who has a single Post with the title Stuff.

When $repository->save() is invoked, a User will be created with the username "Steve", and a Post will be created with the user_id belonging to that User. The nonsensical "nonsense" property is simply ignored, because it does not actually exist on the table storing Users.

A limitation on Eloquent HasManyThrough relationships:

Inputs that define a model related through a HasManyThrough relationship must refer to an already existing model. In this example, a User has many Reactions through a Post. The Reaction model must exist and be related to a Post in order to correctly relate to the User.

A workaround for new Reaction and Post models attached to a User involves nesting the Reaction model data under the related Post

Support for new models defined through a HasThroughMany relationship will come soon.


By itself, EloquentRepository is a blunt weapon with no access controls that should be avoided in any public APIs. It will clobber every relationship it touches without prejudice. For example, the following is a BAD way to add a new Post for the user we just created.

This will delete poor Steve's first post—not the intended effect. The safe(r) way to append a Post would be either of the following:

Generally speaking, the latter is preferred and is less likely to explode in your face.

The public API methods that return models from a repository are:

  1. create
  2. read
  3. update
  4. delete
  5. save, which will either call create or update depending on the state of its input
  6. find, which will find a model by ID
  7. findOrFail, which will find a model by ID or throw \Illuminate\Database\Eloquent\ModelNotFoundException

The public API methods that return an \Illuminate\Database\Eloquent\Collection are:

  1. all

Filtering

Koala\Pouch\Filter handles Eloquent Query Builder modifications based on filter values passed through the filters parameter.

Tokens and usage:

Token Description Example
^ Field starts with https://api.yourdomain.com/1.0/users?filters[name]=^John
$ Field ends with https://api.yourdomain.com/1.0/users?filters[name]=$Smith
~ Field contains https://api.yourdomain.com/1.0/users?filters[favorite_cheese]=~cheddar
< Field is less than https://api.yourdomain.com/1.0/users?filters[lifetime_value]=<50
> Field is greater than https://api.yourdomain.com/1.0/users?filters[lifetime_value]=>50
>= Field is greater than or equals https://api.yourdomain.com/1.0/users?filters[lifetime_value]=>=50
<= Field is less than or equals https://api.yourdomain.com/1.0/users?filters[lifetime_value]=<=50
= Field is equal to https://api.yourdomain.com/1.0/users?filters[username]==Specific%20Username
!= Field is not equal to https://api.yourdomain.com/1.0/users?filters[username]=!=common%20username
[...] Field is one or more of https://api.yourdomain.com/1.0/users?filters[id]=[1,5,10]
![...] Field is not one of https://api.yourdomain.com/1.0/users?filters[id]=![1,5,10]
NULL Field is null https://api.yourdomain.com/1.0/users?filters[address]=NULL
NOT_NULL Field is not null https://api.yourdomain.com/1.0/users?filters[email]=NOT_NULL

Filtering by relations

Assuming we have users and their related tables resembling the following structure:

We can filter users by their hobbies with users?filters[profile.hobbies.name]=^Cook.

This filter can be read as select users with whose profile.hobbies.name begins with "Cook"

Relationships can be of arbitrary depth.

Filter conjunctions

We can use AND and OR statements to build filters such as users?filters[username]==Bobby&filters[or][username]==Johnny&filters[and][profile.favorite_cheese]==Gouda. The PHP array that's built from this filter is:

and this filter can be read as select (users with username Bobby) OR (users with username Johnny whose profile.favorite_cheese attribute is Gouda).

Other Parameters

Pick

We can limit the amount of data that comes back with your query by adding pick to the URL. Usage:

Model Setup

Models need to implement Koala\Pouch\Contracts\PouchResource before Pouch will allow them to be exposed as a Pouch resource. This is done so exposure is an explicit process and no more is exposed than is needed.

Models also need to define their own $fillable array including attributes and relations that can be filled through this model. For example, if a User has many posts and has many comments but an API consumer should only be able to update comments through a user, the $fillable array would look like:

Pouch will only modify attributes/relations that are explicitly defined.

Resolving models

Pouch is great and all, but we don't want to resolve model classes ourselves before we can instantiate a repository...

If you've configured a RESTful URI structure with pluralized resources (i.e. https://api.mydowmain.com/1.0/users maps to the User model), you can use Koala\Pouch\Utility\Modeler to resolve a model class name from a route name.

Testing

phpunit :)

TODO

  1. Route service provider should be pre-setup
  2. Support more relationships (esp. polymorphic relations) through cascading saves.
  3. Support paginating nested relations

All versions of pouch with dependencies

PHP Build Version
Package Version
Requires php Version ^7.4|^8.0
illuminate/database Version ^8|^9|^10
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package koala-labs/pouch contains the following files

Loading the files please wait ....