TonisOrmisson / yii2-helpers

MyArrayHelper.php

<?php
namespace andmemasin\helpers;

use yii\base\InvalidParamException;
use yii\base\BaseObject;
use yii\db\ActiveRecord;
use yii\helpers\ArrayHelper;


/**
 * my additions to yii's default arrayhelper
 *
 * @package app\models\helpers
 * @author Tonis Ormisson <tonis@andmemasin.eu>
 */
class MyArrayHelper extends ArrayHelper{

    /**
     * Take a non-indexed array and make an indexed array using the value 
     * as both index and value
     * @param array $array A NON-INDEXES single dimension array
     * @return array
     * @throws InvalidParamException
     */
    public static function selfIndex($array) {
        if(is_array($array)){

The condition is_array($array) is always true.

            $out = [];
            foreach ($array as $value) {
                $out[$value] = $value;
            }
            return $out;
        }else{
            throw new InvalidParamException(gettype($array).' used as array in '.__CLASS__.'::'.__FUNCTION__);

The class yii\base\InvalidParamException has been deprecated: since 2.0.14. Use [[InvalidArgumentException]] instead.

        }
        
    }


    /**
     * Re-index an array based on a map. Map holds the indexes we want to apply to array.
     * @param array $map
     * @param array $array
     * @return array
     */
    public static function mapIndex($map, $array){
        if(is_array($array)){

The condition is_array($array) is always true.

            $out = [];
            foreach ($map as $key => $value){
                $out[$value] = $array[$key];
            }
            return $out;
        }else{
            throw new InvalidParamException(gettype($array).' used as array in '.__CLASS__.'::'.__FUNCTION__);

The class yii\base\InvalidParamException has been deprecated: since 2.0.14. Use [[InvalidArgumentException]] instead.

        }


    }

    /**
     * Converts an non-indexed MULTIDIMENSIONAL array (such as data matrix from spreadsheet)
     * into an indexed array based on the $i-th element in the array. By default its the 
     * first [0] element (header row). The indexing element will be excluded from output
     * array
     * @param array $array
     * @param integer $i
     * @return array
     */
    public static function indexByRow($array, $i = 0){
        $keys = $array[$i];
        if(is_array($array) && !empty($array)){
            $newArray= [];
            foreach ($array as $key=> $row) {
                // don'd add the indexing element into output
                if($key != $i){
                    $newRow = [];
                    $j = 0;
                    foreach ($row as $cell) {
                        $newRow[$keys[$j]] = $cell;
                        $j++;
                    }
                    $newArray[] = $newRow;
                }
            }
            
            return $newArray;
        }else{
            throw new InvalidParamException(gettype($array).' used as array in '.__CLASS__.'::'.__FUNCTION__);

The class yii\base\InvalidParamException has been deprecated: since 2.0.14. Use [[InvalidArgumentException]] instead.

        }

    }


    /**
     * Take an multi-dimensional array and re-index it by a value in each array element
     * @param array $array
     * @param string $colName
     * @return array
     */
    public static function indexByColumn($array, $colName){
        if(is_array($array)){

The condition is_array($array) is always true.

            if(!empty($array)){
                $newArray= [];
                foreach ($array as $key => $row) {
                    if($row instanceof ActiveRecord){
                        $rowArr = (array) $row->attributes;
                    }else if(is_array($row)){
                        $rowArr = $row;
                    }else{
                        throw new InvalidParamException('Only arrays or ActiveRecord Objects can be used in '.__CLASS__.'::'.__FUNCTION__);

The class yii\base\InvalidParamException has been deprecated: since 2.0.14. Use [[InvalidArgumentException]] instead.

                    }
                    // make it array if input is object

                    if(!isset($rowArr[$colName])){
                        throw new InvalidParamException('"'.$colName.'" missing as key in '.__CLASS__.'::'.__FUNCTION__);

The class yii\base\InvalidParamException has been deprecated: since 2.0.14. Use [[InvalidArgumentException]] instead.

                    }
                    $newArray[$rowArr[$colName]] = $row;
                }
                return $newArray;
            }
            // do nothing, empty array
            return $array;
        }else{
            throw new InvalidParamException(gettype($array).' used as array in '.__CLASS__.'::'.__FUNCTION__);

The class yii\base\InvalidParamException has been deprecated: since 2.0.14. Use [[InvalidArgumentException]] instead.

        }
    }
    
    /**
     * Remove element(s) from array based on their value 
     * @param array $array Haystack
     * @param mixed $removeValue value that we look for to delete
     * @return array
     */
    public static function removeByValue($array,$removeValue,$column = false) {
        foreach ($array as $key =>$value) {
            // if column is set then remove by specific column value
            if($column){

                if($value === $value[$column]){
                    unset($array[$key]);
                }
            }else{
                if($value === $removeValue){
                    unset($array[$key]);
                }
            }

        }
        return $array;
    }

    /**
     * Remove an ActiveRecord model from array of models by a value in one specified attribute
     * @param ActiveRecord[] $models
     * @param string $attribute
     * @param string $value
     * @return ActiveRecord[]
     */
    public static function removeModelByColumnValue($models, $attribute, $value){
        if(!empty($models)){
            foreach ($models as $key => $model){
                if($model->{$attribute} === $value){
                    unset($models[$key]);
                }
            }
        }
        return $models;
    }
}