home/laciafrdyl/www/plugins/loco-translate/src/output/Buffer.php000064400000007234151561075730021133 0ustar00output; } /** * @return Loco_output_Buffer */ public static function start(){ $buffer = new Loco_output_Buffer; return $buffer->open(); } /** * @internal * Ensure buffers closed if something terminates before we close gracefully */ public function __destruct(){ $this->close(); } /** * @return Loco_output_Buffer */ public function open(){ self::check(); if( ! ob_start() ){ throw new Loco_error_Exception('Failed to start output buffering'); } $this->ob_level = ob_get_level(); return $this; } /** * @return Loco_output_Buffer */ public function close(){ if( is_int($this->ob_level) ){ // collect output from our nested buffers $this->output = self::collect( $this->ob_level ); $this->ob_level = null; } return $this; } /** * Trash all open buffers, logging any junk output collected * @return void */ public function discard(){ $this->close(); if( '' !== $this->output ){ self::log_junk( $this->output ); $this->output = ''; } } /** * Collect output buffered to a given level * @param int $min highest buffer to flush, 0 being the root * @return string */ public static function collect( $min ){ $last = 0; $output = ''; while( $level = ob_get_level() ){ // @codeCoverageIgnoreStart if( $level === $last ){ throw new Loco_error_Exception('Failed to close output buffer'); } // @codeCoverageIgnoreEnd if( $level < $min ){ break; } // output is appended inside out: $output = ob_get_clean().$output; $last = $level; } return $output; } /** * Forcefully destroy all open buffers and log any bytes already buffered. * @return void */ public static function clear(){ $junk = self::collect(0); if( '' !== $junk ){ self::log_junk($junk); } } /** * Check output has not already been flushed. * @throws Loco_error_Exception */ public static function check(){ if( headers_sent($file,$line) && 'cli' !== PHP_SAPI ){ $file = str_replace( trailingslashit( loco_constant('ABSPATH') ), '', $file ); // translators: (1) is the name of a PHP script, (2) is a line number in the file throw new Loco_error_Exception( sprintf( __('Loco was interrupted by output from %1$s:%2$u','loco-translate'), $file?:'Unknown', $line ) ); } } /** * Debug collection of junk output * @param string $junk * @return void */ private static function log_junk( $junk ){ $bytes = strlen($junk); $message = sprintf("Cleared %s of buffered output", Loco_mvc_FileParams::renderBytes($bytes) ); Loco_error_AdminNotices::debug( $message ); do_action( 'loco_buffer_cleared', $junk ); } }