<?php
/**
 * This file is copied as a mu-plugin into new WP installs to reroute normal
 * mails into log entries.
 */

/**
 * Replace WP native pluggable wp_mail function for test purposes.
 *
 * @param string|string[] $to Array or comma-separated list of email addresses to send message.
 * @return bool Whether the email was sent successfully.
 *
 * @phpcs:disable WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedFunctionFound -- WP native function.
 */
function wp_mail( $to ) {
    if ( is_array( $to ) ) {
        $to = join( ', ', $to );
    }

    // Log for testing purposes
    WP_CLI::log( "WP-CLI test suite: Sent email to {$to}." );

    // Assume sending mail always succeeds.
    return true;
}
// phpcs:enable