use Code_Snippets\REST_API\Snippets_REST_Controller;
use Code_Snippets\Settings;
use Code_Snippets\Snippet_Files;
use function Code_Snippets\clean_active_snippets_cache;
use function Code_Snippets\clean_snippets_cache;
use function Code_Snippets\execute_snippet;
use function Code_Snippets\code_snippets;
use function Code_Snippets\execute_snippet_from_flat_file;
* Class for evaluating functions snippets.
class Evaluate_Functions {
* @param DB $db Database class instance.
public function __construct( DB $db ) {
add_action( 'plugins_loaded', [ $this, 'evaluate_early' ], 1 );
* Retrieve details about the currently edited snippet, if any.
* @return ?array{id: int, table: string}
private function get_currently_editing_snippet(): ?array {
if ( wp_is_json_request() && ! empty( $_SERVER['REQUEST_URI'] ) ) {
$url = wp_parse_url( esc_url_raw( wp_unslash( $_SERVER['REQUEST_URI'] ) ) );
if ( isset( $url['path'] ) && false !== strpos( $url['path'], Snippets_REST_Controller::get_prefixed_base_route() ) ) {
$path_parts = explode( '/', $url['path'] );
$edit_id = intval( end( $path_parts ) );
if ( ! empty( $url['query'] ) ) {
wp_parse_str( $url['query'], $path_params );
$edit_table = isset( $path_params['network'] ) && rest_sanitize_boolean( $path_params['network'] )
'table' => $edit_table ?? $this->db->table,
* Check if the plugin is running in safe mode.
* @noinspection PhpUndefinedConstantInspection
public function is_safe_mode_active(): bool {
return ( defined( 'CODE_SNIPPETS_SAFE_MODE' ) && CODE_SNIPPETS_SAFE_MODE ) ||
! apply_filters( 'code_snippets/execute_snippets', true );
* Quickly deactivate a snippet with minimal overhead.
* @param int $snippet_id ID of the snippet to deactivate.
* @param string $table_name Name of the table where the snippet is stored.
private function quick_deactivate_snippet( int $snippet_id, string $table_name ) {
$active_shared_ids = get_option( 'active_shared_network_snippets', [] );
$active_shared_ids = is_array( $active_shared_ids )
? array_map( 'intval', $active_shared_ids )
if ( $table_name === $this->db->ms_table && in_array( $snippet_id, $active_shared_ids, true ) ) {
unset( $active_shared_ids[ array_search( $snippet_id, $active_shared_ids, true ) ] );
$active_shared_ids = array_values( $active_shared_ids );
update_option( 'active_shared_network_snippets', $active_shared_ids );
clean_active_snippets_cache( $table_name );
clean_snippets_cache( $table_name );
$network = $table_name === $this->db->ms_table;
do_action( 'code_snippets/deactivate_snippet', $snippet_id, $network );
private function evaluate_snippet_flat_file( array $snippet, string $file_path, ?array $edit_snippet = null ) {
$snippet_id = $snippet['id'];
$code = $snippet['code'];
$table_name = $snippet['table'];
// If the snippet is a single-use snippet, deactivate it before execution to ensure that the process always happens.
if ( 'single-use' === $snippet['scope'] ) {
$this->quick_deactivate_snippet( $snippet_id, $table_name );
if ( ! is_null( $edit_snippet ) && $edit_snippet['id'] === $snippet_id && $edit_snippet['table'] === $table_name ) {
if ( apply_filters( 'code_snippets/allow_execute_snippet', true, $snippet_id, $table_name ) ) {
execute_snippet_from_flat_file( $code, $file_path, $snippet_id );
* Evaluate applicable active snippets as early as possible.
* @return bool True if snippets were evaluated, false if safe mode is active.
public function evaluate_early(): bool {
if ( $this->is_safe_mode_active() ) {
if ( Snippet_Files::is_active() ) {
return $this->evaluate_file_snippets();
return $this->evaluate_db_snippets();
public function evaluate_db_snippets(): bool {
$scopes = [ 'global', 'single-use', is_admin() ? 'admin' : 'front-end' ];
$active_snippets = $this->db->fetch_active_snippets( $scopes );
$edit_snippet = $this->get_currently_editing_snippet();
foreach ( $active_snippets as $snippet ) {
$snippet_id = $snippet['id'];
$code = $snippet['code'];
$table_name = $snippet['table'];
// If the snippet is a single-use snippet, deactivate it before execution to ensure that the process always happens.
if ( 'single-use' === $snippet['scope'] ) {
$this->quick_deactivate_snippet( $snippet_id, $table_name );
if ( apply_filters( 'code_snippets/allow_execute_snippet', true, $snippet_id, $table_name ) &&
( is_null( $edit_snippet ) || $edit_snippet['id'] !== $snippet_id || $edit_snippet['table'] !== $table_name ) ) {
execute_snippet( $code, $snippet_id );
private function evaluate_file_snippets(): bool {
$scopes = [ 'global', 'single-use', is_admin() ? 'admin' : 'front-end' ];
$snippets = Snippet_Files::get_active_snippets_from_flat_files( $scopes, $type );
$edit_snippet = $this->get_currently_editing_snippet();
foreach ( $snippets as $snippet ) {
$table_name = Snippet_Files::get_hashed_table_name( $snippet['table'] );
$base_path = Snippet_Files::get_base_dir( $table_name, $type );
$file = $base_path . '/' . $snippet['id'] . '.' . $type;
$this->evaluate_snippet_flat_file( $snippet, $file, $edit_snippet );