beco/yii-common

Common Yii2 base ActiveRecord and helpers

0.1.3 2025-11-27 07:11 UTC

Requires

• php: >=8.0
• ext-intl: *
• mailgun/mailgun-php: ^3
• raoul2000/yii2-workflow: *
• skeeks/yii2-mobile-detect: ^1.0
• yiisoft/mutex: *
• yiisoft/yii2: ^2.0
• yiisoft/yii2-bootstrap5: ~2.0.2
• yiisoft/yii2-httpclient: *
• yiisoft/yii2-queue: ^2.3
• yiisoft/yii2-smarty: ^2.0

MIT

README

Instalation

composer require beco/yii-common:dev-main

Provides

• new project creator (beco flavored)
• beco\yii\db\ActiveRecord:
  • Human and Relative Dates automatic functions
• beco\yii\models\User: a basic user model (and its migration)
• beco\yii\commands\SystemCommand: a command for
• db backup
• system check

New proyect starter

If you

1. composer composer create-project --prefer-dist yiisoft/yii2-app-basic [PROJECT_NAME]
2. composer require beco\yii-commons

You have a new System command with some great commands:

1. system/setup
2. creates and secures a backup directory
3. marks its run (knowing if it's a first run by not finding such file)
4. moves all files from templates into their specific location (if a file has a variable, injects it and then saves it in the right location, aka $salt) 1. an ActiveRecord facade into the models directory 2. a Users placeholder for the dev to extend User capabilities 3. db, web and console config 4. a beco flavored web/index.php which uses a new beco\yii\web\Application for enforcing https
5. system/migrate migrates (optionally) some other's libraries migrations into the project, such as
6. queue
7. rbac
8. users (beco flavor)

Human and Relative functions

If you have a field which is a date or a datetime column in mysql, aka yyyy-mm-dd or yyyy-mm-dd hh:ii:ss, let's call it starts_at, by extending beco\yii\db\ActiveRecord you automatically have three new functions:

1. $model->starts_atHumanreturns a nice print of the date as "jueves 2 de mayo del 2015 a las 12:34pm"
2. $model->starts_atRelative returns how much time is left for such date in a human way
3. $model->starts_atDateTime a \DateTime representation of such date

Automatically you also have starts_atHuman and startsAtHuman.

Info

Then, in order to get some local handling use intermediate classes:

<?php
namespace app\models;

use beco\yii\db\ActiveRecord as BaseActiveRecord;

abstract class ActiveRecord extends BaseActiveRecord {

}

Changelog

v0.1.2

• add extra (json) to users
• return null if date_time candidate's value is null
• minor fixes in relative time display
• add queue and mutex at composer level
• improved console and web config scritps
• includes Telegram basic client, command, migration and encapsulated response object
• all ActiveRecord are loggable

To do

[] separate system/new from system/setup only for config files rather than code files [x] add LoginForm to templates [] scheduler and beat [x] beco\yii\db\LoggableActiveRecord include log capabilites to all ActiveRecord [] improve documentation [] should all tables from this packages be beco_table_name?