2017 © Pedro Peláez
 

library phly-restfully

ZF2 Module providing structure for RESTful resources

image

phly/phly-restfully

ZF2 Module providing structure for RESTful resources

  • Tuesday, May 31, 2016
  • by weierophinney
  • Repository
  • 26 Watchers
  • 120 Stars
  • 13,916 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 50 Forks
  • 16 Open issues
  • 17 Versions
  • 0 % Grown

The README.md

ABANDONED

As of the 2.3.0 release, I have marked this module as abandoned., (*1)

The module very quickly proved that the approach was worthwhile and useful, and became the seed for Apigility. That project has far surpassed its origins in this module, and added a ton of functionality this module never managed to create, such as content negotiation, file upload handling, entity and collection hydration, and more., (*2)

As such, I recommend using Apigility in favor of PhlyRestfully for new projects, and that existing projects migrate to Apigility when possible., (*3)

This module provides structure and code for quickly implementing RESTful APIs that use JSON as a transport., (*4)

It allows you to create RESTful JSON APIs that use the following standards:, (*5)

  • HAL, used for creating hypermedia links
  • Problem API, used for reporting API problems

Documentation is available at rtfd.org., (*6)

Upgrading

If you were using version 1.0.0 or earlier (the version presented at PHP Benelux 2013), you will need to make some changes to your application to get it to work., (*7)

  • First, the terminology has changed, as have some class names, to reference "resources" instead of "items"; this is more in line with RESTful terminology.
    • As such, if you had any code using PhlyRestfully\HalItem, it should now reference PhlyRestfully\HalResource. Similarly, in that class, you will access the actual resource object now from the resource property instead of the item property. (This should only affect those post-1.0.0).
    • If you want to create link for an individual resource, use the forResource method of HalLinks, and not the forItem method.
    • InvalidItemException was renamed to InvalidResourceException.
  • A number of items were moved from the RestfulJsonModel to the RestfulJsonRenderer.
    • Hydrators
    • The flag for displaying exception backtraces; in fact, you can use the view_manager.display_exceptions configuration setting to set this behavior.
  • All results from the ResourceController are now pushed to a payload variable in the view model.
    • Additionally, ApiProblem, HalResource, and HalCollection are first-class objects, and are used as the payload values.
  • The Links plugin was renamed to HalLinks, and is now also available as a view helper.

LICENSE

This module is licensed using the BSD 2-Clause License:, (*8)

Copyright (c) 2013, Matthew Weier O'Phinney
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.

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 COPYRIGHT HOLDER 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.

The Versions

31/05 2016

dev-develop

dev-develop https://github.com/weierophinney/PhlyRestfully

ZF2 Module providing structure for RESTful resources

  Sources   Download

BSD-2-Clause

The Requires

 

The Development Requires

rest zf2 zend module

31/05 2016

dev-master

9999999-dev https://github.com/weierophinney/PhlyRestfully

ZF2 Module providing structure for RESTful resources

  Sources   Download

BSD-2-Clause

The Requires

 

The Development Requires

rest zf2 zend module

31/05 2016

2.3.1

2.3.1.0 https://github.com/weierophinney/PhlyRestfully

ZF2 Module providing structure for RESTful resources

  Sources   Download

BSD-2-Clause

The Requires

 

The Development Requires

rest zf2 zend module

26/05 2016

2.3.0

2.3.0.0 https://github.com/weierophinney/PhlyRestfully

ZF2 Module providing structure for RESTful resources

  Sources   Download

BSD-2-Clause

The Requires

 

The Development Requires

rest zf2 zend module

14/08 2013

dev-hotfix/95

dev-hotfix/95 https://github.com/weierophinney/PhlyRestfully

ZF2 Module providing structure for RESTful resources

  Sources   Download

BSD-2-Clause

The Requires

 

The Development Requires

rest zf2 zend module

25/07 2013

2.2.0

2.2.0.0 https://github.com/weierophinney/PhlyRestfully

ZF2 Module providing structure for RESTful resources

  Sources   Download

BSD-2-Clause

The Requires

 

The Development Requires

rest zf2 zend module

25/07 2013

dev-feature/79

dev-feature/79 https://github.com/weierophinney/PhlyRestfully

ZF2 Module providing structure for RESTful resources

  Sources   Download

BSD-2-Clause

The Requires

 

The Development Requires

rest zf2 zend module

23/07 2013

2.1.2

2.1.2.0 https://github.com/weierophinney/PhlyRestfully

ZF2 Module providing structure for RESTful resources

  Sources   Download

BSD-2-Clause

The Requires

 

The Development Requires

rest zf2 zend module

02/06 2013

2.1.1

2.1.1.0 https://github.com/weierophinney/PhlyRestfully

ZF2 Module providing structure for RESTful resources

  Sources   Download

BSD-2-Clause

The Requires

 

The Development Requires

rest zf2 zend module

01/06 2013

2.1.0

2.1.0.0 https://github.com/weierophinney/PhlyRestfully

ZF2 Module providing structure for RESTful resources

  Sources   Download

BSD-2-Clause

The Requires

 

The Development Requires

rest zf2 zend module

01/06 2013

2.0.1

2.0.1.0 https://github.com/weierophinney/PhlyRestfully

ZF2 Module providing structure for RESTful resources

  Sources   Download

BSD-2-Clause

The Requires

 

The Development Requires

rest zf2 zend module

09/05 2013

2.0.0

2.0.0.0 https://github.com/weierophinney/PhlyRestfully

ZF2 Module providing structure for RESTful resources

  Sources   Download

BSD-2-Clause

The Requires

 

The Development Requires

rest zf2 zend module

09/05 2013

2.0.0beta4

2.0.0.0-beta4 https://github.com/weierophinney/PhlyRestfully

ZF2 Module providing structure for RESTful resources

  Sources   Download

BSD-2-Clause

The Requires

 

The Development Requires

rest zf2 zend module

27/04 2013

2.0.0beta3

2.0.0.0-beta3 https://github.com/weierophinney/PhlyRestfully

ZF2 Module providing structure for RESTful resources

  Sources   Download

BSD-2-Clause

The Requires

 

The Development Requires

rest zf2 zend module

29/03 2013

2.0.0beta2

2.0.0.0-beta2 https://github.com/weierophinney/PhlyRestfully

ZF2 Module providing structure for RESTful resources

  Sources   Download

BSD-2-Clause

The Requires

 

The Development Requires

rest zf2 zend module

21/03 2013

2.0.0beta1

2.0.0.0-beta1 https://github.com/weierophinney/PhlyRestfully

ZF2 Module providing structure for RESTful resources

  Sources   Download

BSD-2-Clause

The Requires

 

The Development Requires

rest zf2 zend module

21/01 2013

1.0.0

1.0.0.0 https://github.com/weierophinney/PhlyRestfully

ZF2 Module providing structure for RESTful resources

  Sources   Download

BSD-2-Clause

The Requires

 

rest zf2 zend module