Yiisoft\Profiler\FileTarget

Complexity

Total Complexity

9

Size/Duplication

Total Lines	100
Duplicated Lines	0 %

Test Coverage

Coverage

70.97%

Importance

Changes	2
Bugs	0	Features	0

4 Methods

Rating	Name	Duplication	Size	Complexity
A	resolveFilename()	0	15	4
A	formatMessage()	0	7	1
A	setFilename()	0	3	1
A	export()	0	23	3

<?php
declare(strict_types=1);

namespace Yiisoft\Profiler;

use Yiisoft\Files\FileHelper;

/**
 * FileTarget records profiling messages in a file specified via {@see filename}.
 *
 * Application configuration example:
 *
 * ```php
 * return [
 *     'profiler' => [
 *         'targets' => [
 *             [
 *                 '__class' => Yiisoft\Profile\FileTarget::class,
 *                 //'filename' => '@runtime/profiling/{date}-{time}.txt',
 *             ],
 *         ],
 *         // ...
 *     ],
 *     // ...
 * ];
 * ```
 */
class FileTarget extends Target
{
    /**
     * @var string file path or [path alias](guide:concept-aliases). File name may contain the placeholders,
     * which will be replaced by computed values. The supported placeholders are:
     *
     * - '{ts}' - profiling completion timestamp.
     * - '{date}' - profiling completion date in format 'ymd'.
     * - '{time}' - profiling completion time in format 'His'.
     *
     * The directory containing the file will be automatically created if not existing.
     * If target file is already exist it will be overridden.
     */
    private string $filename = '@runtime/profiling/{date}-{time}.txt';

    /**
     * @var int the permission to be set for newly created directories.
     * This value will be used by PHP chmod() function. No umask will be applied.
     * Defaults to 0775, meaning the directory is read-writable by owner and group,
     * but read-only for other users.
     */
    private int $dirMode = 0775;


    public function export(array $messages): void
    {
        $memoryPeakUsage = memory_get_peak_usage();

        // TODO: make sure it works with RoadRunner and alike servers
        $totalTime = microtime(true) - $_SERVER['REQUEST_TIME_FLOAT'];
        $text = "Total processing time: {$totalTime} ms; Peak memory: {$memoryPeakUsage} B. \n\n";

        $text .= implode("\n", array_map([$this, 'formatMessage'], $messages));

        $filename = $this->resolveFilename();

        if (file_exists($filename)) {
            unlink($filename);
        } else {
            $filePath = dirname($filename);

            if (!is_dir($filePath)) {
                FileHelper::createDirectory($filePath, $this->dirMode);
            }
        }

        file_put_contents($filename, $text);
    }

    /**
     * Set profiles filename
     *
     * @param string $value
     *
     * @return void
     *
     * {@see filename}
     */
    public function setFilename(string $value): void
    {
        $this->filename = $value;
    }

    /**
     * Resolves value of {@see filename} processing path alias and placeholders.
     *
     * @return string actual target filename.
     */
    protected function resolveFilename(): string
    {
        $filename = $this->filename;

        return preg_replace_callback('/{\\w+}/', static function ($matches) {
            switch ($matches[0]) {
                case '{ts}':
                    return time();
                case '{date}':
                    return gmdate('ymd');
                case '{time}':
                    return gmdate('His');
            }
            return $matches[0];
        }, $filename);
    }

    /**
     * Formats a profiling message for display as a string.
     *
     * @param array $message the profiling message to be formatted.
     * The message structure follows that in {@see Profiler::$messages}.
     *
     * @return string the formatted message.
     */
    protected function formatMessage(array $message): string
    {
        return date(
            'Y-m-d H:i:s',
            (int) $message['beginTime']
        ) . " [{$message['duration']} ms][{$message['memoryDiff']} B][{$message['category']}] {$message['token']}" .
        __METHOD__;
    }
}