spatie/once
Fork: 56 Star: 1276 (更新于 2024-11-29 01:41:34)
license: MIT
Language: PHP .
A magic memoization function
最后发布版本: 3.1.1 ( 2024-05-27 17:18:16)
A magic memoization function
This package contains a once
function. You can pass a callable
to it. Here's quick example:
$myClass = new class() {
public function getNumber(): int
{
return once(function () {
return rand(1, 10000);
});
}
};
No matter how many times you run $myClass->getNumber()
inside the same request you'll always get the same number.
Are you a visual learner?
Under the hood, this package uses a PHP 8 Weakmap. In this video, you'll see what a weakmap is, together with a nice demo of the package.
Support us
We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.
We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.
Installation
You can install the package via composer:
composer require spatie/once
Usage
The once
function accepts a callable
.
$myClass = new class() {
public function getNumber(): int
{
return once(function () {
return rand(1, 10000);
});
}
};
No matter how many times you run $myClass->getNumber()
you'll always get the same number.
The once
function will only run once per combination of argument values the containing method receives.
class MyClass
{
/**
* It also works in static context!
*/
public static function getNumberForLetter($letter)
{
return once(function () use ($letter) {
return $letter . rand(1, 10000000);
});
}
}
So calling MyClass::getNumberForLetter('A')
will always return the same result, but calling MyClass::getNumberForLetter('B')
will return something else.
Flushing the cache
To flush the entire cache you can call:
Spatie\Once\Cache::getInstance()->flush();
Disabling the cache
In your tests you probably don't want to cache values. To disable the cache you can call:
Spatie\Once\Cache::getInstance()->disable();
You can re-enable the cache with
Spatie\Once\Cache::getInstance()->enable();
Octane compatibility
Warning
This behaviour is in beta and needs to be tested by the community. You can find this topic in discussion #79.
In order to have once
working properly in an Octane environment, Cache::getInstance()->flush()
must be called when OperationTerminated
event is triggered. You can configure it in config/octane.php
file:
// config/octane.php
OperationTerminated::class => [
FlushTemporaryContainerInstances::class,
// DisconnectFromDatabases::class,
// CollectGarbage::class,
FlushSpatieOnce::class, // we should create this class we have added here
],
And create the FlushSpatieOnce:class
:
// app/Listeners/FlushSpatieOnce.php
use Spatie\Once\Cache;
class FlushSpatieOnce
{
public function handle($event)
{
Cache::getInstance()->flush();
}
}
Under the hood
The once
function will execute the given callable and save the result in the $values
property of Spatie\Once\Cache
. This class is a singleton. When we detect that once
has already run before, we're just going to return the value stored inside the $values
weakmap instead of executing the callable again.
The first thing it does is calling debug_backtrace
. We'll use the output to determine in which function and class once
is called and to get access to the object
that function is running in. Yeah, we're already in voodoo-land. The output of the debug_backtrace
is passed to a new instance of Backtrace
. That class is just a simple wrapper, so we can work more easily with the backtrace.
$trace = debug_backtrace(
DEBUG_BACKTRACE_PROVIDE_OBJECT, 2
)[1];
$backtrace = new Backtrace($trace);
$object = $backtrace->getObject();
Next, we calculate a hash
of the backtrace. This hash will be unique per function once
was called in and the values of the arguments that function receives.
$hash = $backtrace->getHash();
Finally, we will check if there's already a value stored for the given hash. If not, then execute the given $callback
and store the result in the weakmap of Spatie\Once\Cache
. In the other case, we just return the value from that cache (the $callback
isn't executed).
public function has(object $object, string $backtraceHash): bool
{
if (! isset($this->values[$object])) {
return false;
}
return array_key_exists($backtraceHash, $this->values[$object]);
}
Changelog
Please see CHANGELOG for more information what has changed recently.
Testing
composer test
Contributing
Please see CONTRIBUTING for details.
Security
If you've found a bug regarding security please mail security@spatie.be instead of using the issue tracker.
Credits
And a special thanks to Caneco for the logo ✨
Credit for the idea of the once
function goes to Taylor Otwell. The code for this package is based upon the code he was kind enough to share with us.
License
The MIT License (MIT). Please see License File for more information.
最近版本更新:(数据更新于 2024-09-17 09:15:27)
2024-05-27 17:18:16 3.1.1
2022-04-21 20:23:49 3.1.0
2022-02-04 17:05:25 3.0.2
2021-07-04 20:06:43 3.0.1
2020-11-03 21:23:27 3.0.0
2020-10-30 02:22:25 2.2.1
2020-02-18 23:11:08 2.2.0
2019-10-31 10:51:06 2.1.3
2019-08-05 15:50:14 2.1.2
2019-06-27 06:24:33 2.1.1
主题(topics):
cache, magic, performance, php
spatie/once同语言 PHP最近更新仓库
2024-12-13 19:38:03 coollabsio/coolify
2024-12-13 09:22:46 w7corp/easywechat
2024-12-11 20:15:22 symfony/symfony
2024-11-29 16:49:37 symfony/var-dumper
2024-11-20 23:58:25 laravel/framework
2024-11-20 18:39:23 danielmiessler/SecLists