horat1us/yii2-carbon-behavior

Yii2 Carbon Timestamps Behavior

1.3.0 2024-11-12 15:11 UTC

Requires

• php: ^8.1
• nesbot/carbon: ^2.0 | ^3.0
• yiisoft/yii2: ^2.0.47

Requires (Dev)

• horat1us/yii2-asset-free: ^1.0
• phpunit/phpunit: ^9.5
• squizlabs/php_codesniffer: ^3.7

MIT

• Alexander Letnikow

README

Behavior to generate timestamps (created_at, updated_at etc.) using Carbon instance.

Main purpose of using Carbon (instead of native time() function, implemented in \yii\behaviors\TimestampBehavior) is ability to mock this values without tricks (using Carbon::setTestNow()).

Used in real projects with MySQL and PostgreSQL.

Installation

Using packagist.org:

composer require horat1us/yii2-carbon-behavior:^1.3

Usage

To generate timestamps using Carbon

<?php

namespace App;

use Horat1us\Yii\CarbonBehavior;
use yii\db;

/**
* Class Record
 * @package App
 * 
 * @property string $created_at [timestamp]
 * @property string $updated_at [timestamp]
 */
class Record extends db\ActiveRecord
{
    public function behaviors(): array {
        return [
            'uuid' => [
                'class' => CarbonBehavior::class,    
            ],    
        ];
    }
}

in followed example created_at and updated_at attributes will be filled with date and time generated using Carbon class.

License

MIT