insert_with_markers()

将一个字符串数组插入文件（.htaccess），将其放在BEGIN和END标记之间。

原型

insert_with_markers( string $filename, string $marker, array|string $insertion )

描述

替换现有的标记信息。保留周围的数据。如果不存在则创建文件。

参数

$filename (string) (Required) 要更改的文件名。

$marker (string) (Required) 要改变的标记。

$insertion (array|string) (Required) 要插入的新内容。

返回值

(bool)  写入成功时为真，失败时为假。

源文件

路径：wp-admin/includes/misc.php

<?php
...
function insert_with_markers( $filename, $marker, $insertion ) {
	if ( ! file_exists( $filename ) ) {
		if ( ! is_writable( dirname( $filename ) ) ) {
			return false;
		}
		if ( ! touch( $filename ) ) {
			return false;
		}
	} elseif ( ! is_writeable( $filename ) ) {
		return false;
	}
	if ( ! is_array( $insertion ) ) {
		$insertion = explode( "n", $insertion );
	}
	$start_marker = "# BEGIN {$marker}";
	$end_marker   = "# END {$marker}";
	$fp = fopen( $filename, 'r+' );
	if ( ! $fp ) {
		return false;
	}
	// Attempt to get a lock. If the filesystem supports locking, this will block until the lock is acquired.
	flock( $fp, LOCK_EX );
	$lines = array();
	while ( ! feof( $fp ) ) {
		$lines[] = rtrim( fgets( $fp ), "rn" );
	}
	// Split out the existing file into the preceding lines, and those that appear after the marker
	$pre_lines = $post_lines = $existing_lines = array();
	$found_marker = $found_end_marker = false;
	foreach ( $lines as $line ) {
		if ( ! $found_marker && false !== strpos( $line, $start_marker ) ) {
			$found_marker = true;
			continue;
		} elseif ( ! $found_end_marker && false !== strpos( $line, $end_marker ) ) {
			$found_end_marker = true;
			continue;
		}
		if ( ! $found_marker ) {
			$pre_lines[] = $line;
		} elseif ( $found_marker && $found_end_marker ) {
			$post_lines[] = $line;
		} else {
			$existing_lines[] = $line;
		}
	}
	// Check to see if there was a change
	if ( $existing_lines === $insertion ) {
		flock( $fp, LOCK_UN );
		fclose( $fp );
		return true;
	}
	// Generate the new file data
	$new_file_data = implode( "n", array_merge(
		$pre_lines,
		array( $start_marker ),
		$insertion,
		array( $end_marker ),
		$post_lines
	) );
	// Write to the start of the file, and truncate it to that length
	fseek( $fp, 0 );
	$bytes = fwrite( $fp, $new_file_data );
	if ( $bytes ) {
		ftruncate( $fp, ftell( $fp ) );
	}
	fflush( $fp );
	flock( $fp, LOCK_UN );
	fclose( $fp );
	return (bool) $bytes;
}
...
?>

其他

英文文档：https://developer.wordpress.org/reference/functions/insert_with_markers/