getMessage() ); if ( '' === $msg ) { $msg = get_class( $e ); } return sprintf( /* translators: 1: phase, 2: error message, 3: source file and line */ __( '[%1$s] %2$s (at %3$s)', '007aj-backup-restore-verifier' ), '' !== $phase ? $phase : 'job', $msg, self::where( $e->getFile(), $e->getLine() ) ); } /** * Describe a PHP fatal error captured at shutdown. * * @param array $err error_get_last() result. * @param string $phase Phase. */ public static function describe_fatal( array $err, string $phase ): string { return sprintf( /* translators: 1: phase, 2: error message, 3: source file and line */ __( '[%1$s] PHP fatal error: %2$s (at %3$s)', '007aj-backup-restore-verifier' ), '' !== $phase ? $phase : 'job', trim( (string) ( $err['message'] ?? '' ) ), self::where( (string) ( $err['file'] ?? '' ), (int) ( $err['line'] ?? 0 ) ) ); } /** * Prefix a driver-reported error with its phase (once). * * @param string $message Message. * @param string $phase Phase. */ public static function with_phase( string $message, string $phase ): string { $message = trim( $message ); if ( '' === $phase || \brverify_str_starts_with( $message, '[' ) ) { return $message; } return '[' . $phase . '] ' . $message; } /** * Short source location (path relative to wp-content when possible). * * @param string $file File. * @param int $line Line. */ private static function where( string $file, int $line ): string { $file = str_replace( '\\', '/', $file ); $base = defined( 'BRVERIFY_FILE' ) ? str_replace( '\\', '/', dirname( dirname( dirname( BRVERIFY_FILE ) ) ) ) . '/' : ''; if ( '' !== $base && \brverify_str_starts_with( $file, $base ) ) { $file = substr( $file, strlen( $base ) ); } return $file . ':' . $line; } }