Feature: callable relation params

[zsilbi]

Hello!

• Type: new feature

In raising this pull request, I confirm the following:

• I have read and understood the Contributing Guidelines
• I have checked that another pull request for this purpose does not exist
• I wrote some tests for this PR
• I have updated the relevant CHANGELOG
• I have created a PR for the documentation about this change: Feature: callable relation params phalcon-orphanage/docs#2787

Small description of change:

Modified Phalcon\Mvc\Model\Relation to accept callable params for model relations.

Example use case:

/**
 * @var DiInterface $container
 */
$container = $this->getDI();

$this->hasMany(
    'id', Documents::class, 'customerId', [
        'params' => function() use ($container) {
            /**
             * @var Languages $language
             */
            $language = $container->getShared('language');

            return [
                'languageId = :languageId:',
                'bind' => [
                    'languageId' => $language->id
                ]
            ];
        }
    ]
);

When language is changed in the dependency container, the relations will automatically use the new parameter.

Thanks,
zsilbi

[Jeckerson]

But isn't it the same, when just pass an array directly inside 'params'?

/**
 * @var DiInterface $container
 */
$container = $this->getDI();

/**
  * @var Languages $language
  */
$language = $container->getShared('language');

$this->hasMany(
    'id', Documents::class, 'customerId', [
        'params' => [
                'languageId = :languageId:',
                'bind' => [
                    'languageId' => $language->id
                ]
            ]
    ]
);

[zsilbi]

@Jeckerson

The models are only initialized once and I need a way to keep these parameters up to date.

That function is evaluated every time before the relations are accessed, so if the language changes between queries in the container, the languageId in the params will be updated.