RTC Hybrid: Table with awareness in object cache when available.

src/wp-admin/admin.php

@@ -113,6 +113,14 @@
 	wp_schedule_event( time(), 'daily', 'delete_expired_transients' );
 }
 
+// Schedule collaboration data cleanup.
+if ( wp_is_collaboration_enabled()
+	&& ! wp_next_scheduled( 'wp_delete_old_collaboration_data' )
+	&& ! wp_installing()
+) {
+	wp_schedule_event( time(), 'daily', 'wp_delete_old_collaboration_data' );
+}
+
 set_screen_options();
 
 $date_format = __( 'F j, Y' );

src/wp-admin/includes/schema.php

@@ -186,6 +186,20 @@ function wp_get_db_schema( $scope = 'all', $blog_id = null ) {
 	KEY post_parent (post_parent),
 	KEY post_author (post_author),
 	KEY type_status_author (post_type,post_status,post_author)
+) $charset_collate;
+CREATE TABLE $wpdb->collaboration (
+	collaboration_id bigint(20) unsigned NOT NULL auto_increment,
+	room varchar($max_index_length) NOT NULL default '',
+	type varchar(32) NOT NULL default '',
+	client_id varchar(32) NOT NULL default '',
+	user_id bigint(20) unsigned NOT NULL default '0',
+	data longtext NOT NULL,
+	date_gmt datetime NOT NULL default '0000-00-00 00:00:00',
+	PRIMARY KEY  (collaboration_id),
+	KEY type_client_id (type,client_id),
+	KEY room (room,collaboration_id),
+	KEY room_type_date (room,type,date_gmt),
+	KEY date_gmt (date_gmt)
 ) $charset_collate;\n";
 
 	// Single site users table. The multisite flavor of the users table is handled below.

src/wp-admin/includes/upgrade.php

@@ -886,7 +886,7 @@ function upgrade_all() {
 		upgrade_682();
 	}
 
-	if ( $wp_current_db_version < 61644 ) {
+	if ( $wp_current_db_version < 62315 ) {
 		upgrade_700();
 	}
 

src/wp-includes/class-wp-post-type.php

@@ -339,6 +339,24 @@ final class WP_Post_Type {
 	 *
 	 * @since 4.6.0
 	 * @var stdClass $cap
+	 *
+	 * @phpstan-var object{
+	 *     edit_post: string,
+	 *     read_post: string,
+	 *     delete_post: string,
+	 *     edit_posts: string,
+	 *     edit_others_posts: string,
+	 *     delete_posts: string,
+	 *     publish_posts: string,
+	 *     read_private_posts: string,
+	 *     create_posts: string,
+	 *     read?: string,
+	 *     delete_private_posts?: string,
+	 *     delete_published_posts?: string,
+	 *     delete_others_posts?: string,
+	 *     edit_private_posts?: string,
+	 *     edit_published_posts?: string,
+	 * }
 	 */
 	public $cap;
 

src/wp-includes/class-wp-taxonomy.php

@@ -162,6 +162,13 @@ final class WP_Taxonomy {
 	 *
 	 * @since 4.7.0
 	 * @var stdClass
+	 *
+	 * @phpstan-var object{
+	 *     manage_terms: string,
+	 *     edit_terms: string,
+	 *     delete_terms: string,
+	 *     assign_terms: string,
+	 * }
 	 */
 	public $cap;
 

src/wp-includes/class-wpdb.php

@@ -299,6 +299,7 @@ class wpdb {
 		'term_relationships',
 		'termmeta',
 		'commentmeta',
+		'collaboration',
 	);
 
 	/**
@@ -404,6 +405,15 @@ class wpdb {
 	 */
 	public $posts;
 
+	/**
+	 * WordPress Collaboration table.
+	 *
+	 * @since 7.0.0
+	 *
+	 * @var string
+	 */
+	public $collaboration;
+
 	/**
 	 * WordPress Terms table.
 	 *

src/wp-includes/collaboration.php

@@ -11,16 +11,15 @@
  *
  * If the WP_ALLOW_COLLABORATION constant is false,
  * collaboration is always disabled regardless of the database option.
- * Otherwise, falls back to the 'wp_collaboration_enabled' option.
  *
  * @since 7.0.0
  *
  * @return bool Whether real-time collaboration is enabled.
  */
-function wp_is_collaboration_enabled() {
+function wp_is_collaboration_enabled(): bool {
 	return (
 		wp_is_collaboration_allowed() &&
-		(bool) get_option( 'wp_collaboration_enabled' )
+		get_option( 'wp_collaboration_enabled' )
 	);
 }
 
@@ -32,11 +31,17 @@ function wp_is_collaboration_enabled() {
  * The constant defaults to true, unless the WP_ALLOW_COLLABORATION
  * environment variable is set to string "false".
  *
+ * Also requires the database schema introduced in db_version 62282.
+ *
  * @since 7.0.0
  *
- * @return bool Whether real-time collaboration is enabled.
+ * @return bool Whether real-time collaboration is allowed.
  */
-function wp_is_collaboration_allowed() {
+function wp_is_collaboration_allowed(): bool {
+	if ( get_option( 'db_version' ) < 62282 ) {
+		return false;
+	}
+
 	if ( ! defined( 'WP_ALLOW_COLLABORATION' ) ) {
 		$env_value = getenv( 'WP_ALLOW_COLLABORATION' );
 		if ( false === $env_value ) {
@@ -45,14 +50,14 @@ function wp_is_collaboration_allowed() {
 		} else {
 			/*
 			 * Environment variable is defined, let's confirm it is actually set to
-			 * "true" as it may still have a string value "false" – the preceeding
+			 * "true" as it may still have a string value "false" – the preceding
 			 * `if` branch only tests for the boolean `false`.
 			 */
 			define( 'WP_ALLOW_COLLABORATION', 'true' === $env_value );
 		}
 	}
 
-	return WP_ALLOW_COLLABORATION;
+	return (bool) WP_ALLOW_COLLABORATION;
 }
 
 /**
@@ -64,7 +69,7 @@ function wp_is_collaboration_allowed() {
  *
  * @global string $pagenow The filename of the current screen.
  */
-function wp_collaboration_inject_setting() {
+function wp_collaboration_inject_setting(): void {
 	global $pagenow;
 
 	if ( ! wp_is_collaboration_enabled() ) {
@@ -83,3 +88,43 @@ function wp_collaboration_inject_setting() {
 		'after'
 	);
 }
+
+/**
+ * Deletes stale collaboration data from the collaboration table.
+ *
+ * Removes non-awareness rows older than 7 days and awareness rows older
+ * than 60 seconds. Rows left behind by abandoned collaborative editing
+ * sessions are cleaned up to prevent unbounded table growth.
+ *
+ * @since 7.0.0
+ *
+ * @global wpdb $wpdb WordPress database abstraction object.
+ */
+function wp_delete_old_collaboration_data(): void {
+	global $wpdb;
+
+	if ( ! wp_is_collaboration_enabled() ) {
+		/*
+		 * Collaboration was enabled in the past but has since been disabled.
+		 * Unschedule the cron job prior to clean up so this callback does not
+		 * continue to run.
+		 */
+		wp_clear_scheduled_hook( 'wp_delete_old_collaboration_data' );
+	}
+
+	// Clean up rows older than 7 days.
+	$wpdb->query(
+		(string) $wpdb->prepare(
+			"DELETE FROM {$wpdb->collaboration} WHERE date_gmt < %s",
+			gmdate( 'Y-m-d H:i:s', time() - WEEK_IN_SECONDS )
+		)
+	);
+
+	// Clean up awareness rows older than 60 seconds.
+	$wpdb->query(
+		(string) $wpdb->prepare(
+			"DELETE FROM {$wpdb->collaboration} WHERE type = 'awareness' AND date_gmt < %s",
+			gmdate( 'Y-m-d H:i:s', time() - 60 )
+		)
+	);
+}