<?php
/**
 * Journal de débogage : n'écrit que si WP_DEBUG et WP_DEBUG_LOG sont actifs.
 *
 * @package Torlann
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

if ( ! function_exists( 'torlann_debug_log' ) ) {
	/**
	 * Écrit un message dans le journal PHP uniquement en mode débogage WordPress.
	 *
	 * @param string $message Message sans donnée personnelle.
	 * @return void
	 */
	function torlann_debug_log( $message ) {
		if ( ! defined( 'WP_DEBUG' ) || ! WP_DEBUG || ! defined( 'WP_DEBUG_LOG' ) || ! WP_DEBUG_LOG ) {
			return;
		}
		// phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log -- Only runs when WP_DEBUG and WP_DEBUG_LOG are enabled.
		error_log( '[Torlann] ' . (string) $message );
	}
}

if ( ! function_exists( 'torlann_filesystem' ) ) {
	/**
	 * Instance WP_Filesystem (accès direct) pour les fichiers locaux du plugin.
	 *
	 * @return WP_Filesystem_Base|null
	 */
	function torlann_filesystem() {
		global $wp_filesystem;
		if ( $wp_filesystem instanceof WP_Filesystem_Direct ) {
			return $wp_filesystem;
		}
		static $direct = null;
		if ( null !== $direct ) {
			return $direct;
		}

		// Fichiers locaux uniquement (uploads, dossier temporaire) : accès direct, sans identifiants FTP.
		require_once ABSPATH . 'wp-admin/includes/file.php';
		if ( 'direct' === get_filesystem_method() && WP_Filesystem() && $wp_filesystem instanceof WP_Filesystem_Direct ) {
			$direct = $wp_filesystem;
			return $direct;
		}

		// Hébergement configuré en FTP/SSH : les chemins locaux restent accessibles en direct.
		if ( ! class_exists( 'WP_Filesystem_Direct' ) ) {
			require_once ABSPATH . 'wp-admin/includes/class-wp-filesystem-base.php';
			require_once ABSPATH . 'wp-admin/includes/class-wp-filesystem-direct.php';
		}
		$direct = new WP_Filesystem_Direct( null );
		return $direct;
	}
}

if ( ! function_exists( 'torlann_put_contents' ) ) {
	/**
	 * Écrit un fichier via WP_Filesystem.
	 *
	 * @param string $path     Chemin absolu.
	 * @param string $contents Contenu.
	 * @return bool
	 */
	function torlann_put_contents( $path, $contents ) {
		$fs = torlann_filesystem();
		if ( ! $fs ) {
			return false;
		}
		return (bool) $fs->put_contents( $path, (string) $contents, defined( 'FS_CHMOD_FILE' ) ? FS_CHMOD_FILE : 0644 );
	}
}