PHP code example of polyspirit / bitrix-builder

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

polyspirit / bitrix-builder example snippets

use \polyspirit\Bitrix\Builder\IBlock;

// set iBlock ID as first parameter
$iBlockById = new IBlock(12);

// iBlock CODE as first parameter
$iBlockByCode = new IBlock('news');

// iBlock CODE as first parameter and site ID as second parameter
$iBlockByCodeAndSiteID = new IBlock('news', 's1');

$iBlock = new IBlock('news');
$arResult = $iBlock->getElements();

$iBlock = new IBlock('news');
$arResultDetail = $iBlock->filter(['ID' => 42])->getElement();

// show SOME_CODE property value
echo $arResultDetail['PROPS']['SOME_CODE']['VALUE'];

// show path to picture
echo $arResultDetail['PICTURE_SRC']; // /upload/resize_cache/iblock/xxx/xxx_xxx_1/some_picture.ext

public IBlock::active(): IBlock

// example: 
$iBlock->active()->getElements();

public IBlock::sort(array $array): IBlock

// sort by default: 
['sort' => 'ASC', 'date_active_from' => 'DESC', 'created_date' => 'DESC']

// example: 
$iBlock->sort(['sort' => 'DESC', 'ID' => 'DESC'])->getElements();

public IBlock::sortReset(): IBlock

// example: 
$iBlock->sortReset()->sort(['ID' => 'DESC'])->getElements();

public IBlock::filter(array $array): IBlock

// example:
$iBlock->filter(['>=TIMESTAMP_X' => date('Y-m-d h:i:s', 'yesterday')])->getElements();

public IBlock::fields(array $array): IBlock

// fields by default: 
['ID', 'IBLOCK_ID']

// fields by default if method is not used: 
['*']

// example (select ID, IBLOCK_ID, NAME, PREVIEW_PICTURE): 
$iBlock->fields(['NAME', 'PREVIEW_PICTURE'])->getElements();

public IBlock::navs(array $array): IBlock

$iBlock->navs(['nPageSize' => 4, 'iNumPage' => 1, 'checkOutOfRange' => true])->getElements();

public IBlock::sizes(array $array): IBlock

// sizes by default: 
['width' => 640, 'height' => 640]

// example: 
$iBlock->sizes(['width' => 1280, 'height' => 720])->getElements();

public IBlock::params(array $array): IBlock

// example: 
$params = [
    'sort' => ['ID' => 'DESC'],
    'filter' => ['>=TIMESTAMP_X' => date('Y-m-d h:i:s', 'yesterday')],
    'navs' => ['nPageSize' => 4, 'iNumPage' => 1, 'checkOutOfRange' => true],
    'fields' => ['NAME', 'CODE'],
    'sizes' => ['width' => 1280, 'height' => 720]
];
$iBlock->params($params)->getElements();

public IBlock::getElement(Closure $closure = null): array

// example: 
$handler = function (&$element) {
    $element['ID_CODE'] = $element['ID'] . '|' . $element['CODE'];
}
$arDetail = $iBlock->filter(['ID' => 42])->fields(['CODE'])->getElement($handler);

echo $arDetail['ID_CODE']; // 42|ELEMENT_CODE

public IBlock::getElements(Closure $closure = null): array

// example: 
$handler = function (&$element) {
    $element['ID_CODE'] = $element['ID'] . '|' . $element['CODE'];
}
$arResult = $iBlock->filter(['>=ID' => 42])->fields(['CODE'])->getElements($handler);

foreach ($arResult as $element) {
    echo $element['ID_CODE']; // 42|ELEMENT_CODE
}

public IBlock::add(array $fields, array $props = []): int

// example:
(new IBlock('news'))->add(
    [
        'NAME' => 'Some',
        'PREVIEW_TEXT' => 'Some text'
    ], 
    [
        'SOME_PROPERTY_CODE' => 42
    ]
);

public IBlock::update(string|int $id, array $fields, array $props = []): bool

// example:
(new IBlock('news'))->update(
    [
        'NAME' => 'Updated name',
        'PREVIEW_TEXT' => 'Updated text'
    ], 
    [
        'SOME_PROPERTY_CODE' => 24
    ]
);

public IBlock::delete(string|int|null $id = null): bool

// example:
(new IBlock('news'))->delete(42);

// or:
$iBlock = new IBlock('news');
$iBlock->add(['NAME' => 'SOME']);
$iBlock->delete();

public IBlock::getObResult(): CIBlockResult|int

// example:
$arResult = $iBlock->filter(['>=ID' => 42])->getElements();
$obResult = $iBlock->getObResult();

public IBlock::

// example:
(new IBlock('news'))->

public IBlock::getPropertySubQuery(string $propName, string $propValue): array

// example:
$subquery = $iBlock->getPropertySubQuery('SOME_CODE', 42);
$iBlock->filter([$subquery])->getElement();

public static IBlock::getIdByCode(string $code = '', $siteId = SITE_ID): false|mixed

// example:
$id = IBlock::getIdByCode('some_iblock_code');

public static IBlock::getResizeImageSrc($pictureId, array $sizes): string

// example:
$pathToPicture = IBlock::getResizeImageSrc(42, ['width' => 1280, 'height' => 720]);