Fixin is under development to be a simple and flexible public framework that built from the ground for PHP 7.1+ Web: http://www.fixinphp.com GitHub: https://github.com/fixin/Fixin

1. Fixin Framework
Attila Jenei

2. Fixin Framework
• Owner-managed classes
• Flexible
• Simple dispatch flow
• Built for PHP 7.1+

3. Owner-Managed Classes
• Constructor-based injection via options
__construct($resourceManager, array $options, string $name);
• No public dependency getters and setters
• Responsibility goes to the creator
• Class constants
• Prevents mistyping and hidden not-used options

4. Managed Class
• Abstract implementation of ManagedInterface
• Supports lazy-loading
• Supports options mapping
• Declares $options processing

5. Lazy-Loading
• Declaring property
$this->setLazyLoadingProperty(static::ENTITY, EntityInterface::class, $value);
• $value is a key to Resource Manager
• Loading property
protected function getEntity(): EntityInterface
{
return $this->entity ?: $this->loadLazyProperty(static::ENTITY);
}

6. Options Mapping
protected const THIS_SETS = [
self::DELAY => [Types::INT, Types::NULL],
self::NAME => [self::USING_SETTER, Types::NULL],
self::REPOSITORY => [self::LAZY_LOADING => RepositoryInterface::class]
]
• List of possible options and their allowed types
• Supports lazy-loading
• Supports custom setters

7. Resource Manager
• Holds shared Resources and preinitialized Prototypes
• Has configuration for the keys
• Supports creation by class name, Factory, and
Abstract Factory
• Request with undefined key interpreted as class name

8. Resource Manager
• Getting a Resource:
$manager->get(‘BaseJsonJson’, JsonInterface::class);
• Loads options from the configuration on initialization
• Returns a ResourceInterface
• Always returns the same instance for the given key

9. Resource Manager
• Cloning a Prototype:
$manager->clone(‘BaseJsonJson’, JsonInterface::class, [
JsonInterface::DECODING_MAX_DEPTH => 2
]);
• Loads options from the configuration on
preinitialization
• Returns a cloned instance for the given key with the
additional options

10. Flexibility
• Interface-based classes
• Resource Manager configuration
• Namespace fallback support

11. Interfaces
• All classes use interface types
• Option names are defined as interface constants
• All class replaceable with custom implementation

12. Resouce Manager
Configuration
• Options for the keys
• Option inheritance
• Configuration of ‘B’ key inherited from ‘A’ key
• Aliases

13. Namespace Fallback
• Referencing without top level
• The root namespace will be determined
• Defined root search order
• Zero configuration for class overriding
• Just put into the right folder

14. Namespace Fallback
Example:
• Requesting ‘*ViewView’
• Manager looks for ‘AppViewView’
• then: ‘FixinViewView’

15. Simple Dispatch Flow
• Information Cargo
• Cargo Handlers
• Called Delivery System

16. Cargo
• Holds the content and its type
• Delivered flag shows final state
• Subtypes has other data too

17. HTTP Cargo
• Environment, Server
• Cookies, Session
• Protocol Version, Uri, Method
• Request Headers, Parameters
• Status Code, Response Headers

18. Cargo Handlers
• One required method
public function handle(CargoInterface $cargo): CargoInterface
{…}

19. Delivery System
• Application creates a Cargo
• Cargo goes through a Route
• Route builds up from Nodes
• A Hub might send to other handler
(Action Handler, Restful Handler, Route)
• Application unpacks the Cargo

20. Nodes
• ArrayToJson
• HttpClassHub
• HttpErrorHub
• HttpNotFoundFallback
• HttpRouterHub
• JsonToArray
• ThrowableToText
• ViewRender
• WrapInView

21. PHP 7.1+
• Parameter type declarations
• Return type declarations
• Nullable types
• Void functions
• Null coalescing operator
• Class constant visibility

22. Visit https://blog.fixinphp.com