$signals Masked crawl signals. */ public function validate( array $signals ): void { $items = 0; $this->validate_value( $signals, 0, $items ); } /** * @param mixed $value Signal value. */ private function validate_value( $value, int $depth, int &$items ): void { if ( $depth > self::MAX_DEPTH || ++$items > self::MAX_ITEMS ) { throw new InvalidArgumentException( 'crawl_signals_budget_exceeded' ); } if ( is_array( $value ) ) { foreach ( $value as $key => $child ) { if ( is_string( $key ) ) { $this->validate_key( $key ); } $this->validate_value( $child, $depth + 1, $items ); } return; } if ( is_string( $value ) ) { if ( strlen( $value ) > 128 || ( '' !== $value && 1 !== preg_match( '/^[A-Za-z0-9][A-Za-z0-9._:-]*$/', $value ) ) ) { throw new InvalidArgumentException( 'unsafe_crawl_signal_value' ); } return; } if ( is_float( $value ) && ! is_finite( $value ) ) { throw new InvalidArgumentException( 'invalid_crawl_signal_number' ); } if ( ! is_int( $value ) && ! is_float( $value ) && ! is_bool( $value ) && null !== $value ) { throw new InvalidArgumentException( 'invalid_crawl_signal_type' ); } } private function validate_key( string $key ): void { if ( 1 !== preg_match( '/^[a-z][a-z0-9_]{0,63}$/', $key ) ) { throw new InvalidArgumentException( 'invalid_crawl_signal_key' ); } if ( 1 === preg_match( '/(?:^|_)(?:body|content|cookie|email|header|html|location|password|path|payload|secret|token|url|username)(?:s|_|$)/', $key ) ) { throw new InvalidArgumentException( 'unsafe_crawl_signal_key' ); } } }