https://github.com/laravel/serializable-closure

Laravel Serializable Closure provides an easy and secure way to serialize closures in PHP.
https://github.com/laravel/serializable-closure

closure php serialize

Last synced: about 1 month ago
JSON representation

Laravel Serializable Closure provides an easy and secure way to serialize closures in PHP.

• Host: GitHub
• URL: https://github.com/laravel/serializable-closure
• Owner: laravel
• License: mit
• Created: 2021-09-07T15:01:16.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2024-01-26T17:22:24.000Z (8 months ago)
• Last Synced: 2024-04-23T10:35:43.789Z (5 months ago)
• Topics: closure, php, serialize
• Language: PHP
• Homepage:
• Size: 200 KB
• Stars: 466
• Watchers: 13
• Forks: 28
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE.md
  • Code of conduct: .github/CODE_OF_CONDUCT.md
  • Security: .github/SECURITY.md
  • Support: .github/SUPPORT.md

Awesome Lists containing this project

• awesome-php - Laravel Serializable Closure - A library that allows Closures to be serialized. (Configuration / Miscellaneous)

README

        
# Serializable Closure



    





    





    





    



## Introduction

> This project is a fork of the excellent [opis/closure: 3.x](https://github.com/opis/closure) package. At Laravel, we decided to fork this package as the upcoming version [4.x](https://github.com/opis/closure) is a complete rewrite on top of the [FFI extension](https://www.php.net/manual/en/book.ffi.php). As Laravel is a web framework, and FFI is not enabled by default in web requests, this fork allows us to keep using the `3.x` series while adding support for new PHP versions.

Laravel Serializable Closure provides an easy and secure way to **serialize closures in PHP**.

## Official Documentation

### Installation

> **Requires [PHP 7.4+](https://php.net/releases/)**

First, install Laravel Serializable Closure via the [Composer](https://getcomposer.org/) package manager:

```bash

composer require laravel/serializable-closure

```

### Usage

You may serialize a closure this way:

```php

use Laravel\SerializableClosure\SerializableClosure;

$closure = fn () => 'james';

// Recommended

SerializableClosure::setSecretKey('secret');

$serialized = serialize(new SerializableClosure($closure));

$closure = unserialize($serialized)->getClosure();

echo $closure(); // james;

```

### Caveats

* Anonymous classes cannot be created within closures.

* Attributes cannot be used within closures.

* Serializing closures on REPL environments like Laravel Tinker is not supported.

* Serializing closures that reference objects with readonly properties is not supported.

## Contributing

Thank you for considering contributing to Serializable Closure! The contribution guide can be found in the [Laravel documentation](https://laravel.com/docs/contributions).

## Code of Conduct

In order to ensure that the Laravel community is welcoming to all, please review and abide by the [Code of Conduct](https://laravel.com/docs/contributions#code-of-conduct).

## Security Vulnerabilities

Please review [our security policy](https://github.com/laravel/serializable-closure/security/policy) on how to report security vulnerabilities.

## License

Serializable Closure is open-sourced software licensed under the [MIT license](LICENSE.md).