• SplArray
    • 用途
    • 核心对象方法
      • get
      • set
      • __toString
      • getArrayCopy
      • unset
      • delete
      • unique
      • multiple
      • asort
      • ksort
      • sort
      • column
      • flip
      • filter
      • keys
      • values
      • flush
      • loadArray
      • toXML

    SplArray

    用途

    用于处理数组数据，比如排序，过滤等等。

    核心对象方法

    核心类：EasySwoole\Spl\SplArray。

    get

    获取数组中某项的值。

    • mixed $name 数据项索引

    function get($path)

    例子

    1. <?php
    2. /**
    3.  * Created by PhpStorm.
    4.  * User: root
    5.  * Date: 19-1-9
    6.  * Time: 上午10:10
    7.  */
    9. require './vendor/autoload.php';
    11. $data = [
    12.     'fruit' => [
    13.         'apple' => 2,
    14.         'orange' => 1,
    15.         'grape' => 4
    16.     ],
    17.     'color' => [
    18.         'red' => 12,
    19.         'blue' => 8,
    20.         'green' => 6
    21.     ]
    22. ];
    24. $splArray = new \EasySwoole\Spl\SplArray($data);
    25. var_dump($splArray->get('fruit.apple'));
    27. /**
    28.  * 输出结果过：
    29.  * int(2)
    30.  */

    set

    设置数组中某项的值。

    • mixed $path 数据项索引
    • mixed $value 数据

    function set($path, $value)

    例子

    1. <?php
    2. /**
    3.  * Created by PhpStorm.
    4.  * User: root
    5.  * Date: 19-1-9
    6.  * Time: 上午10:10
    7.  */
    9. require './vendor/autoload.php';
    11. $data = [
    12.     'fruit' => [
    13.         'apple' => 2,
    14.         'orange' => 1,
    15.         'grape' => 4
    16.     ],
    17.     'color' => [
    18.         'red' => 12,
    19.         'blue' => 8,
    20.         'green' => 6
    21.     ]
    22. ];
    24. $splArray = new \EasySwoole\Spl\SplArray($data);
    26. $splArray->set('fruit.apple', 3);
    28. var_dump($splArray->get('fruit.apple'));
    30. /**
    31.  * 输出结果过：
    32.  * int(3)
    33.  */

    __toString

    进行 JSON 编码

    function __toString()

    例子

    1. <?php
    2. /**
    3.  * Created by PhpStorm.
    4.  * User: root
    5.  * Date: 19-1-9
    6.  * Time: 上午10:10
    7.  */
    9. require './vendor/autoload.php';
    11. $data = [
    12.     'fruit' => [
    13.         'apple' => 2,
    14.         'orange' => 1,
    15.         'grape' => 4
    16.     ],
    17.     'color' => [
    18.         'red' => 12,
    19.         'blue' => 8,
    20.         'green' => 6
    21.     ]
    22. ];
    24. $splArray = new \EasySwoole\Spl\SplArray($data);
    25. var_dump($splArray->__toString());
    27. /**
    28.  * 输出结果过：
    29.  * string(80) "{"fruit":{"apple":2,"orange":1,"grape":4},"color":{"red":12,"blue":8,"green":6}}"
    30.  */

    getArrayCopy

    强制转换成数组

    function getArrayCopy()

    例子

    1. <?php
    2. /**
    3.  * Created by PhpStorm.
    4.  * User: root
    5.  * Date: 19-1-9
    6.  * Time: 上午10:10
    7.  */
    9. require './vendor/autoload.php';
    11. $data = [
    12.     'fruit' => [
    13.         'apple' => 2,
    14.         'orange' => 1,
    15.         'grape' => 4
    16.     ],
    17.     'color' => [
    18.         'red' => 12,
    19.         'blue' => 8,
    20.         'green' => 6
    21.     ]
    22. ];
    24. $splArray = new \EasySwoole\Spl\SplArray($data);
    25. var_dump($splArray->__toString());
    27. /**
    28.  * 输出结果过：
    29.  * array(2) {
    30.  *   ["fruit"]=>
    31.  *   array(3) {
    32.  *     ["apple"]=>
    33.  *     int(2)
    34.  *     ["orange"]=>
    35.  *     int(1)
    36.  *     ["grape"]=>
    37.  *     int(4)
    38.  *   }
    39.  *   ["color"]=>
    40.  *   array(3) {
    41.  *     ["red"]=>
    42.  *     int(12)
    43.  *     ["blue"]=>
    44.  *     int(8)
    45.  *     ["green"]=>
    46.  *     int(6)
    47.  *   }
    48.  * }
    49.  * 
    50.  */

    unset

    去除某个数据项

    • mixed $path 数据项索引

    function unset($path)

    例子

    1. <?php
    2. /**
    3.  * Created by PhpStorm.
    4.  * User: root
    5.  * Date: 19-1-9
    6.  * Time: 上午10:10
    7.  */
    9. require './vendor/autoload.php';
    11. $data = [
    12.     'fruit' => [
    13.         'apple' => 2,
    14.         'orange' => 1,
    15.         'grape' => 4
    16.     ],
    17.     'color' => [
    18.         'red' => 12,
    19.         'blue' => 8,
    20.         'green' => 6
    21.     ]
    22. ];
    24. $splArray = new \EasySwoole\Spl\SplArray($data);
    26. $splArray->unset('fruit.apple');
    28. var_dump($splArray->__toString());
    30. /**
    31.  * 输出结果过：
    32.  * array(2) {
    33.  *   ["fruit"]=>
    34.  *   array(2) {
    35.  *     ["orange"]=>
    36.  *     int(1)
    37.  *     ["grape"]=>
    38.  *     int(4)
    39.  *   }
    40.  *   ["color"]=>
    41.  *   array(3) {
    42.  *     ["red"]=>
    43.  *     int(12)
    44.  *     ["blue"]=>
    45.  *     int(8)
    46.  *     ["green"]=>
    47.  *     int(6)
    48.  * }
    49.  }
    51.  */

    delete

    去除某个数据项

    • mixed $key 数据项索引

    public function delete($key)

    ps: unset和delete方法其实是实现统一效果，因考虑旧版本用户使用情况，故而保留。

    例子

    1. <?php
    2. /**
    3.  * Created by PhpStorm.
    4.  * User: root
    5.  * Date: 19-1-9
    6.  * Time: 上午10:10
    7.  */
    9. require './vendor/autoload.php';
    11. $data = [
    12.     'fruit' => [
    13.         'apple' => 2,
    14.         'orange' => 1,
    15.         'grape' => 4
    16.     ],
    17.     'color' => [
    18.         'red' => 12,
    19.         'blue' => 8,
    20.         'green' => 6
    21.     ]
    22. ];
    24. $splArray = new \EasySwoole\Spl\SplArray($data);
    26. $splArray->delete('fruit.apple');
    28. var_dump($splArray->__toString());
    30. /**
    31.  * 输出结果过：
    32.  * array(2) {
    33.  *   ["fruit"]=>
    34.  *   array(2) {
    35.  *     ["orange"]=>
    36.  *     int(1)
    37.  *     ["grape"]=>
    38.  *     int(4)
    39.  *   }
    40.  *   ["color"]=>
    41.  *   array(3) {
    42.  *     ["red"]=>
    43.  *     int(12)
    44.  *     ["blue"]=>
    45.  *     int(8)
    46.  *     ["green"]=>
    47.  *     int(6)
    48.  *   }
    49.  * }
    50.  */

    unique

    移除数组中重复的值

    public function unique()

    例子

    1. <?php
    2. /**
    3.  * Created by PhpStorm.
    4.  * User: root
    5.  * Date: 19-1-9
    6.  * Time: 上午10:10
    7.  */
    9. require './vendor/autoload.php';
    11. $data = [
    12.     'apple' => 2,
    13.     'orange' => 1,
    14.     'grape' => 2,
    15.     'pear' => 4,
    16.     'banana' => 8
    17. ];
    19. $splArray = new \EasySwoole\Spl\SplArray($data);
    20. var_dump($splArray->unique()->getArrayCopy());
    22. /**
    23.  * 输出结果过：
    24.  * array(4) {
    25.  *   ["apple"]=>
    26.  *   int(2)
    27.  *   ["orange"]=>
    28.  *   int(1)
    29.  *   ["pear"]=>
    30.  *   int(4)
    31.  *   ["banana"]=>
    32.  *   int(8)
    33.  * }
    34.  */

    multiple

    获取数组中重复的值

    public function multiple()

    例子

    1. <?php
    2. /**
    3.  * Created by PhpStorm.
    4.  * User: root
    5.  * Date: 19-1-9
    6.  * Time: 上午10:10
    7.  */
    9. require './vendor/autoload.php';
    11. $data = [
    12.     'apple' => 2,
    13.     'orange' => 1,
    14.     'grape' => 2,
    15.     'pear' => 4,
    16.     'banana' => 8
    17. ];
    19. $splArray = new \EasySwoole\Spl\SplArray($data);
    20. var_dump($splArray->unique()->getArrayCopy());
    22. /**
    23.  * 输出结果过：
    24.  * array(1) {
    25.  *   ["grape"]=>
    26.  *   int(2)
    27.  * }
    28.  */

    asort

    进行排序并保持索引关系

    public function asort()

    例子

    1. <?php
    2. /**
    3.  * Created by PhpStorm.
    4.  * User: root
    5.  * Date: 19-1-9
    6.  * Time: 上午10:10
    7.  */
    9. require './vendor/autoload.php';
    11. $data = [
    12.     'apple' => 2,
    13.     'orange' => 1,
    14.     'grape' => 2,
    15.     'pear' => 4,
    16.     'banana' => 8
    17. ];
    19. $splArray = new \EasySwoole\Spl\SplArray($data);
    20. var_dump($splArray->asort()->getArrayCopy());
    22. /**
    23.  * 输出结果过：
    24.  * array(5) {
    25.  *   ["orange"]=>
    26.  *   int(1)
    27.  *   ["apple"]=>
    28.  *   int(2)
    29.  *   ["grape"]=>
    30.  *   int(2)
    31.  *   ["pear"]=>
    32.  *   int(4)
    33.  *   ["banana"]=>
    34.  *   int(8)
    35.  * }
    36.  */

    ksort

    按照键名排序

    public function ksort()

    例子

    1. <?php
    2. /**
    3.  * Created by PhpStorm.
    4.  * User: root
    5.  * Date: 19-1-9
    6.  * Time: 上午10:10
    7.  */
    9. require './vendor/autoload.php';
    11. $data = [
    12.     'apple' => 2,
    13.     'orange' => 1,
    14.     'grape' => 2,
    15.     'pear' => 4,
    16.     'banana' => 8
    17. ];
    19. $splArray = new \EasySwoole\Spl\SplArray($data);
    20. var_dump($splArray->ksort()->getArrayCopy());
    22. /**
    23.  * 输出结果过：
    24.  * array(5) {
    25.  *   ["apple"]=>
    26.  *   int(2)
    27.  *   ["banana"]=>
    28.  *   int(8)
    29.  *   ["grape"]=>
    30.  *   int(2)
    31.  *   ["orange"]=>
    32.  *   int(1)
    33.  *   ["pear"]=>
    34.  *   int(4)
    35.  * }
    36.  */

    sort

    自定义排序

    • mixed $sort_flags 比较类型

    public function sort($sort_flags = SORT_REGULAR)

    • SORT_REGULAR - 正常比较单元（不改变类型）
    • SORT_NUMERIC - 单元被作为数字来比较
    • SORT_STRING - 单元被作为字符串来比较
    • SORT_LOCALE_STRING - 根据当前的区域（locale）设置来把单元当作字符串比较，可以用 setlocale() 来改变
    • SORT_NATURAL - 和 natsort() 类似对每个单元以“自然的顺序”对字符串进行排序。 PHP 5.4.0 中新增的。
    • SORT_FLAG_CASE - 能够与 SORT_STRING 或 SORT_NATURAL 合并（OR 位运算），不区分大小写排序字符串。

    例子

    1. <?php
    2. /**
    3.  * Created by PhpStorm.
    4.  * User: root
    5.  * Date: 19-1-9
    6.  * Time: 上午10:10
    7.  */
    9. require './vendor/autoload.php';
    11. $data = [
    12.     'apple' => 2,
    13.     'orange' => 1,
    14.     'grape' => 2,
    15.     'pear' => 4,
    16.     'banana' => 8
    17. ];
    19. $splArray = new \EasySwoole\Spl\SplArray($data);
    20. var_dump($splArray->ksort()->getArrayCopy());
    22. /**
    23.  * 输出结果过：
    24.  * array(5) {
    25.  *   [0]=>
    26.  *   int(1)
    27.  *   [1]=>
    28.  *   int(2)
    29.  *   [2]=>
    30.  *   int(2)
    31.  *   [3]=>
    32.  *   int(4)
    33.  *   [4]=>
    34.  *   int(8)
    35.  * }
    36.  */

    column

    取得某一列

    • mixed $column 列索引
    • mixed $index_key 返回数组的索引/键的列

    public function column($column, $index_key = null)

    例子

    1. <?php
    2. /**
    3.  * Created by PhpStorm.
    4.  * User: root
    5.  * Date: 19-1-9
    6.  * Time: 上午10:10
    7.  */
    9. require './vendor/autoload.php';
    11. $data = [
    12.     'fruit' => [
    13.         'apple' => 2,
    14.         'orange' => 1,
    15.         'grape' => 4
    16.     ],
    17.     'color' => [
    18.         'red' => 2,
    19.         'blue' => 8,
    20.         'green' => 6
    21.     ]
    22. ];
    24. $splArray = new \EasySwoole\Spl\SplArray($data);
    25. var_dump($splArray->column('apple')->getArrayCopy());
    27. /**
    28.  * 输出结果过：
    29.  * array(1) {
    30.  *   [0]=>
    31.  *   int(2)
    32.  * }
    33.  */

    flip

    交换数组中的键和值

    public function flip()

    例子

    1. <?php
    2. /**
    3.  * Created by PhpStorm.
    4.  * User: root
    5.  * Date: 19-1-9
    6.  * Time: 上午10:10
    7.  */
    9. require './vendor/autoload.php';
    11. $data = [
    12.     'apple' => 2,
    13.     'orange' => 1,
    14.     'grape' => 2,
    15.     'pear' => 4,
    16.     'banana' => 8
    17. ];
    19. $splArray = new \EasySwoole\Spl\SplArray($data);
    20. var_dump($splArray->flip()->getArrayCopy());
    22. /**
    23.  * 输出结果过：
    24.  * array(4) {
    25.  *   [2]=>
    26.  *   string(5) "grape"
    27.  *   [1]=>
    28.  *   string(6) "orange"
    29.  *   [4]=>
    30.  *   string(4) "pear"
    31.  *   [8]=>
    32.  *   string(6) "banana"
    33.  * }
    34.  */

    filter

    过滤数组数据

    • mixed $keys 需要取得/排除的键
    • mixed $exclude true则排除设置的键名 false则仅获取设置的键名

    public function filter($keys, $exclude = false)

    例子

    1. <?php
    2. /**
    3.  * Created by PhpStorm.
    4.  * User: root
    5.  * Date: 19-1-9
    6.  * Time: 上午10:10
    7.  */
    9. require './vendor/autoload.php';
    11. $data = [
    12.     'apple' => 2,
    13.     'orange' => 1,
    14.     'grape' => 2,
    15.     'pear' => 4,
    16.     'banana' => 8
    17. ];
    19. $splArray = new \EasySwoole\Spl\SplArray($data);
    20. var_dump($splArray->filter('apple,orange')->getArrayCopy());
    22. /**
    23.  * 输出结果过：
    24.  * array(2) {
    25.  *   ["apple"]=>
    26.  *   int(2)
    27.  *   ["orange"]=>
    28.  *   int(1)
    29.  * }
    30.  */

    keys

    获取数组索引

    • mixed $path 数据项索引

    public function keys($path = null)

    例子

    1. <?php
    2. /**
    3.  * Created by PhpStorm.
    4.  * User: root
    5.  * Date: 19-1-9
    6.  * Time: 上午10:10
    7.  */
    9. require './vendor/autoload.php';
    11. $data = [
    12.     'fruit' => [
    13.         'apple' => 2,
    14.         'orange' => 1,
    15.         'grape' => 4
    16.     ],
    17.     'color' => [
    18.         'red' => 2,
    19.         'blue' => 8,
    20.         'green' => 6
    21.     ]
    22. ];
    24. $splArray = new \EasySwoole\Spl\SplArray($data);
    25. var_dump($splArray->keys('fruit'));
    27. /**
    28.  * 输出结果过：
    29.  * array(3) {
    30.  *   [0]=>
    31.  *   string(5) "apple"
    32.  *   [1]=>
    33.  *   string(6) "orange"
    34.  *   [2]=>
    35.  *   string(5) "grape"
    36.  * }
    37.  */

    values

    获取数组中所有的值

    public function values()

    例子

    1. <?php
    2. /**
    3.  * Created by PhpStorm.
    4.  * User: root
    5.  * Date: 19-1-9
    6.  * Time: 上午10:10
    7.  */
    9. require './vendor/autoload.php';
    11. $data = [
    12.     'fruit' => [
    13.         'apple' => 2,
    14.         'orange' => 1,
    15.         'grape' => 4
    16.     ],
    17.     'color' => [
    18.         'red' => 2,
    19.         'blue' => 8,
    20.         'green' => 6
    21.     ]
    22. ];
    24. $splArray = new \EasySwoole\Spl\SplArray($data);
    25. var_dump($splArray->values()->getArrayCopy());
    27. /**
    28.  * 输出结果过：
    29.  * array(2) {
    30.  *   [0]=>
    31.  *   array(3) {
    32.  *     ["apple"]=>
    33.  *     int(2)
    34.  *     ["orange"]=>
    35.  *     int(1)
    36.  *     ["grape"]=>
    37.  *     int(4)
    38.  *   }
    39.  *   [1]=>
    40.  *   array(3) {
    41.  *     ["red"]=>
    42.  *     int(2)
    43.  *     ["blue"]=>
    44.  *     int(8)
    45.  *     ["green"]=>
    46.  *     int(6)
    47.  *   }
    48.  * }
    49.  */

    flush

    清空数据

    public function flush()

    例子

    1. <?php
    2. /**
    3.  * Created by PhpStorm.
    4.  * User: root
    5.  * Date: 19-1-9
    6.  * Time: 上午10:10
    7.  */
    9. require './vendor/autoload.php';
    11. $data = [
    12.     'fruit' => [
    13.         'apple' => 2,
    14.         'orange' => 1,
    15.         'grape' => 4
    16.     ],
    17.     'color' => [
    18.         'red' => 2,
    19.         'blue' => 8,
    20.         'green' => 6
    21.     ]
    22. ];
    24. $splArray = new \EasySwoole\Spl\SplArray($data);
    25. var_dump($splArray->flush()->getArrayCopy());
    27. /**
    28.  * 输出结果过：
    29.  * array(0) {
    30.  * }
    31.  */

    loadArray

    重新加载数据

    • array $data 数据

    public function loadArray(array $data)

    例子

    1. <?php
    2. /**
    3.  * Created by PhpStorm.
    4.  * User: root
    5.  * Date: 19-1-9
    6.  * Time: 上午10:10
    7.  */
    9. require './vendor/autoload.php';
    11. $data = [
    12.     'fruit' => [
    13.         'apple' => 2,
    14.         'orange' => 1,
    15.         'grape' => 4
    16.     ],
    17.     'color' => [
    18.         'red' => 2,
    19.         'blue' => 8,
    20.         'green' => 6
    21.     ]
    22. ];
    24. $splArray = new \EasySwoole\Spl\SplArray($data);
    26. $data = [
    27.     'apple' => 2,
    28.     'orange' => 1,
    29.     'grape' => 2,
    30.     'pear' => 4,
    31.     'banana' => 8
    32. ];
    34. var_dump($splArray->loadArray($data)->getArrayCopy());
    36. /**
    37. * 输出结果过：
    38.  * array(5) {
    39.  *   ["apple"]=>
    40.  *   int(2)
    41.  *   ["orange"]=>
    42.  *   int(1)
    43.  *   ["grape"]=>
    44.  *   int(2)
    45.  *   ["pear"]=>
    46.  *   int(4)
    47.  *   ["banana"]=>
    48.  *   int(8)
    49.  * }
    50.  */

    toXML

    转化成xml

    • mixed $CD_DATA 是否需要CDTA标志
    • mixed $rootName 跟节点名称
    • mixed $encoding 编码

    public function toXML($CD_DATA = false,$rootName = ‘xml’,$encoding = ‘UTF-8’)

    例子

    1. <?php
    2. /**
    3.  * Created by PhpStorm.
    4.  * User: root
    5.  * Date: 19-1-9
    6.  * Time: 上午10:10
    7.  */
    9. require './vendor/autoload.php';
    11. $data = [
    12.     'fruit' => [
    13.         'apple' => 2,
    14.         'orange' => 1,
    15.         'grape' => 4
    16.     ],
    17.     'color' => [
    18.         'red' => 2,
    19.         'blue' => 8,
    20.         'green' => 6
    21.     ]
    22. ];
    24. $splArray = new \EasySwoole\Spl\SplArray($data);
    25. var_dump($splArray->toXML());
    27. /**
    28.  * 输出结果过：
    29.  * string(134) "<xml><fruit><apple>2</apple><orange>1</orange><grape>4</grape></fruit><color><red>2</red><blue>8</blue><green>6</green></color></xml>"
    30.  */