略微加速

PHP官方手册 - 互联网笔记

PHP - Manual: Emit callbacks

2024-12-22

Emit callbacks

Emit callbacks are invoked when an instance of a registered class is emitted by yaml_emit() or yaml_emit_file(). The callback is passed the object to be emitted. The callback must return an array having two keys: "tag" and "data". The value associated with the "tag" key must be a string to be used as the YAML tag in the output. The value associated with the "data" key will be encoded as YAML and emitted in place of the intercepted object.

示例 #1 Emit callback example

<?php
class EmitExample {
  public 
$data;    // data may be in any pecl/yaml suitable type

  
public function __construct ($d) {
    
$this->data $d;
  }

  
/**
   * Yaml emit callback function, referred on yaml_emit call by class name.
   *
   * Expected to return an array with 2 values:
   *   - 'tag': custom tag for this serialization
   *   - 'data': value to convert to yaml (array, string, bool, number)
   *
   * @param object $obj Object to be emitted
   * @return array Tag and surrogate data to emit
   */
  
public static function yamlEmit (EmitExample $obj) {
    return array(
      
'tag' => '!example/emit',
      
'data' => $obj->data,
    );
  }
}

$emit_callbacks = array(
  
'EmitExample' => array('EmitExample''yamlEmit')
);

$t = new EmitExample(array('a','b','c'));
$yaml yaml_emit(
  array(
    
'example' => $t,
  ),
  
YAML_ANY_ENCODING,
  
YAML_ANY_BREAK,
  
$emit_callbacks
);
var_dump($yaml);
?>

以上例程的输出类似于:

string(43) "---
example: !example/emit
- a
- b
- c
...
"
add a noteadd a note

User Contributed Notes

There are no user contributed notes for this page.

官方地址:https://www.php.net/manual/en/yaml.callbacks.emit.php

北京半月雨文化科技有限公司.版权所有 京ICP备12026184号-3