Upload 4 files

README-HF-SPACES.md

@@ -0,0 +1,186 @@
+# WordPress on Hugging Face Spaces
+
+这是一个专门为 Hugging Face Spaces 优化的 WordPress Docker 部署方案。
+
+## 🚀 特性
+
+- **WordPress 6.8.1** - 最新稳定版本
+- **PHP 8.3** - 高性能 PHP 版本
+- **SQLite 数据库** - 无需外部数据库服务
+- **Apache Web 服务器** - 稳定可靠
+- **端口 7860** - 符合 HF Spaces 要求
+- **预配置设置** - 开箱即用
+- **演示内容** - 包含示例文章和用户
+
+## 📋 部署到 Hugging Face Spaces
+
+### 方法 1: 直接上传文件
+
+1. 在 Hugging Face 创建新的 Space
+2. 选择 "Docker" 作为 SDK
+3. 上传以下文件到你的 Space:
+   ```
+   Dockerfile.hf-spaces  → Dockerfile
+   wp-config-hf.php
+   db.php
+   start-hf.sh
+   README-HF-SPACES.md   → README.md
+   ```
+
+### 方法 2: Git 推送
+
+1. 克隆你的 HF Space 仓库:
+   ```bash
+   git clone https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME
+   cd YOUR_SPACE_NAME
+   ```
+
+2. 复制必要文件:
+   ```bash
+   cp path/to/wordpress-master/Dockerfile.hf-spaces ./Dockerfile
+   cp path/to/wordpress-master/wp-config-hf.php .
+   cp path/to/wordpress-master/db.php .
+   cp path/to/wordpress-master/start-hf.sh .
+   cp path/to/wordpress-master/README-HF-SPACES.md ./README.md
+   ```
+
+3. 提交并推送:
+   ```bash
+   git add .
+   git commit -m "Add WordPress for HF Spaces"
+   git push
+   ```
+
+## 🔧 配置说明
+
+### Dockerfile 修改
+
+- **端口配置**: 从 80 改为 7860
+- **数据库**: 使用 SQLite 替代 MySQL
+- **依赖**: 添加 SQLite 支持
+- **权限**: 优化文件权限设置
+
+### WordPress 配置
+
+- **数据库**: SQLite 文件存储在 `wp-content/database/`
+- **URL 检测**: 自动检测 HTTPS 和域名
+- **安全**: 禁用文件编辑，启用强制 HTTPS
+- **性能**: 优化内存限制和缓存设置
+
+### 启动脚本
+
+- **初始化**: 自动创建必要目录和数据库
+- **权限**: 设置正确的文件权限
+- **健康检查**: 提供状态页面
+- **演示内容**: 可选的示例内容
+
+## 🎯 访问信息
+
+部署完成后，你可以通过以下方式访问:
+
+- **主页**: `https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space/`
+- **管理面板**: `https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space/wp-admin/`
+- **健康检查**: `https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space/health.html`
+
+### 默认登录信息
+
+- **用户名**: `demo`
+- **密码**: `demo123`
+- **邮箱**: `[email protected]`
+
+> ⚠️ **安全提醒**: 首次登录后请立即更改默认密码！
+
+## 📁 文件结构
+
+```
+/var/www/html/
+├── wp-config.php          # WordPress 配置
+├── wp-content/
+│   ├── database/          # SQLite 数据库文件
+│   ├── plugins/           # 插件目录
+│   ├── themes/            # 主题目录
+│   ├── uploads/           # 上传文件
+│   └── db.php            # SQLite 集成
+├── .htaccess             # URL 重写规则
+└── health.html           # 健康检查页面
+```
+
+## ⚠️ 限制和注意事项
+
+### Hugging Face Spaces 限制
+
+1. **存储**: 数据不会永久保存，重启后丢失
+2. **资源**: CPU 和内存有限制
+3. **网络**: 某些外部连接可能受限
+4. **插件**: 某些需要特殊权限的插件可能无法使用
+
+### 建议用途
+
+- ✅ **演示和测试**: 展示 WordPress 功能
+- ✅ **开发环境**: 临时开发和调试
+- ✅ **教学用途**: WordPress 学习和培训
+- ❌ **生产环境**: 不适合正式网站
+- ❌ **数据存储**: 重要数据会丢失
+
+## 🔧 自定义配置
+
+### 修改端口 (如果需要)
+
+在 `Dockerfile.hf-spaces` 中修改:
+```dockerfile
+# 将 7860 改为其他端口
+sed -i 's/Listen 80/Listen YOUR_PORT/' /etc/apache2/ports.conf
+EXPOSE YOUR_PORT
+```
+
+### 添加插件或主题
+
+在 `Dockerfile.hf-spaces` 中添加:
+```dockerfile
+# 下载并安装插件
+RUN wget -O plugin.zip "PLUGIN_DOWNLOAD_URL" && \
+    unzip plugin.zip -d /var/www/html/wp-content/plugins/ && \
+    rm plugin.zip
+```
+
+### 修改 PHP 设置
+
+在 `Dockerfile.hf-spaces` 中调整:
+```dockerfile
+RUN { \
+    echo 'memory_limit = 512M'; \
+    echo 'upload_max_filesize = 64M'; \
+    echo 'post_max_size = 64M'; \
+} > /usr/local/etc/php/conf.d/custom.ini
+```
+
+## 🐛 故障排除
+
+### 常见问题
+
+1. **无法访问**: 检查端口是否为 7860
+2. **数据库错误**: 确保 SQLite 扩展已安装
+3. **权限错误**: 检查文件权限设置
+4. **插件问题**: 某些插件可能不兼容 SQLite
+
+### 调试方法
+
+1. 查看容器日志
+2. 访问 `/health.html` 检查状态
+3. 检查 `/wp-content/database/` 目录权限
+4. 启用 WordPress 调试模式
+
+## 📚 相关资源
+
+- [WordPress 官方文档](https://wordpress.org/documentation/)
+- [Hugging Face Spaces 文档](https://huggingface.co/docs/hub/spaces)
+- [SQLite Database Integration 插件](https://wordpress.org/plugins/sqlite-database-integration/)
+- [Docker 官方文档](https://docs.docker.com/)
+
+## 🤝 贡献
+
+欢迎���交 Issue 和 Pull Request 来改进这个项目！
+
+## 📄 许可证
+
+本项目遵循 WordPress 的 GPL v2 许可证。

db.php

@@ -0,0 +1,145 @@
+<?php
+/**
+ * SQLite integration for WordPress
+ * This file enables WordPress to use SQLite database instead of MySQL
+ */
+
+// Prevent direct access
+if (!defined('ABSPATH')) {
+    exit;
+}
+
+// Check if SQLite extension is available
+if (!extension_loaded('pdo_sqlite')) {
+    wp_die('SQLite PDO extension is not available. Please install php-sqlite3.');
+}
+
+// Define SQLite database path
+if (!defined('DB_FILE')) {
+    define('DB_FILE', ABSPATH . 'wp-content/database/wordpress.db');
+}
+
+// Create database directory if it doesn't exist
+$db_dir = dirname(DB_FILE);
+if (!file_exists($db_dir)) {
+    wp_mkdir_p($db_dir);
+}
+
+/**
+ * Custom database class for SQLite
+ */
+class SQLite_DB {
+    private $pdo;
+    private $last_error = '';
+    private $last_insert_id = 0;
+    private $num_rows = 0;
+    
+    public function __construct() {
+        $this->connect();
+    }
+    
+    private function connect() {
+        try {
+            $this->pdo = new PDO('sqlite:' . DB_FILE);
+            $this->pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
+            $this->pdo->exec('PRAGMA foreign_keys = ON');
+        } catch (PDOException $e) {
+            $this->last_error = $e->getMessage();
+            wp_die('Database connection failed: ' . $this->last_error);
+        }
+    }
+    
+    public function query($sql) {
+        try {
+            // Convert MySQL syntax to SQLite
+            $sql = $this->mysql_to_sqlite($sql);
+            
+            $stmt = $this->pdo->prepare($sql);
+            $result = $stmt->execute();
+            
+            if ($result) {
+                $this->last_insert_id = $this->pdo->lastInsertId();
+                $this->num_rows = $stmt->rowCount();
+                return $stmt;
+            }
+            
+            return false;
+        } catch (PDOException $e) {
+            $this->last_error = $e->getMessage();
+            return false;
+        }
+    }
+    
+    private function mysql_to_sqlite($sql) {
+        // Basic MySQL to SQLite conversion
+        $sql = str_replace('`', '"', $sql);
+        $sql = preg_replace('/AUTO_INCREMENT/i', 'AUTOINCREMENT', $sql);
+        $sql = preg_replace('/INT\(\d+\)/i', 'INTEGER', $sql);
+        $sql = preg_replace('/TINYINT\(\d+\)/i', 'INTEGER', $sql);
+        $sql = preg_replace('/BIGINT\(\d+\)/i', 'INTEGER', $sql);
+        $sql = preg_replace('/VARCHAR\((\d+)\)/i', 'TEXT', $sql);
+        $sql = preg_replace('/LONGTEXT/i', 'TEXT', $sql);
+        $sql = preg_replace('/DATETIME/i', 'TEXT', $sql);
+        $sql = preg_replace('/TIMESTAMP/i', 'TEXT', $sql);
+        
+        return $sql;
+    }
+    
+    public function get_results($sql, $output = OBJECT) {
+        $stmt = $this->query($sql);
+        if (!$stmt) return null;
+        
+        $results = [];
+        while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
+            if ($output === OBJECT) {
+                $results[] = (object) $row;
+            } else {
+                $results[] = $row;
+            }
+        }
+        
+        return $results;
+    }
+    
+    public function get_row($sql, $output = OBJECT) {
+        $stmt = $this->query($sql);
+        if (!$stmt) return null;
+        
+        $row = $stmt->fetch(PDO::FETCH_ASSOC);
+        if (!$row) return null;
+        
+        if ($output === OBJECT) {
+            return (object) $row;
+        }
+        
+        return $row;
+    }
+    
+    public function get_var($sql) {
+        $stmt = $this->query($sql);
+        if (!$stmt) return null;
+        
+        $row = $stmt->fetch(PDO::FETCH_NUM);
+        return $row ? $row[0] : null;
+    }
+    
+    public function insert_id() {
+        return $this->last_insert_id;
+    }
+    
+    public function last_error() {
+        return $this->last_error;
+    }
+    
+    public function num_rows() {
+        return $this->num_rows;
+    }
+}
+
+// Initialize SQLite database connection
+$wpdb = new SQLite_DB();
+
+// WordPress database compatibility
+if (!isset($GLOBALS['wpdb'])) {
+    $GLOBALS['wpdb'] = $wpdb;
+}

start-hf.sh

@@ -0,0 +1,133 @@
+#!/bin/bash
+set -e
+
+echo "Starting WordPress for Hugging Face Spaces..."
+
+# Create necessary directories
+mkdir -p /var/www/html/wp-content/database
+mkdir -p /var/www/html/wp-content/uploads
+mkdir -p /var/www/html/wp-content/cache
+
+# Set proper permissions
+chown -R www-data:www-data /var/www/html
+chmod -R 755 /var/www/html
+chmod 644 /var/www/html/.htaccess
+
+# Initialize SQLite database if it doesn't exist
+if [ ! -f "/var/www/html/wp-content/database/wordpress.db" ]; then
+    echo "Initializing WordPress database..."
+    
+    # Create empty SQLite database
+    touch /var/www/html/wp-content/database/wordpress.db
+    chown www-data:www-data /var/www/html/wp-content/database/wordpress.db
+    chmod 644 /var/www/html/wp-content/database/wordpress.db
+    
+    # Initialize WordPress tables using WP-CLI if available, or let WordPress handle it
+    echo "Database will be initialized on first visit"
+fi
+
+# Create a simple index.html for health check
+cat > /var/www/html/health.html << 'EOF'
+<!DOCTYPE html>
+<html>
+<head>
+    <title>WordPress on Hugging Face Spaces</title>
+    <meta charset="utf-8">
+    <style>
+        body { font-family: Arial, sans-serif; margin: 40px; background: #f1f1f1; }
+        .container { background: white; padding: 20px; border-radius: 8px; box-shadow: 0 2px 4px rgba(0,0,0,0.1); }
+        .status { color: #46b450; font-weight: bold; }
+        .info { background: #e7f3ff; padding: 15px; border-radius: 4px; margin: 20px 0; }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <h1>🚀 WordPress on Hugging Face Spaces</h1>
+        <p class="status">✅ Service is running</p>
+        <div class="info">
+            <h3>📋 Setup Information:</h3>
+            <ul>
+                <li><strong>WordPress Version:</strong> 6.8.1</li>
+                <li><strong>PHP Version:</strong> 8.3</li>
+                <li><strong>Database:</strong> SQLite</li>
+                <li><strong>Web Server:</strong> Apache</li>
+            </ul>
+        </div>
+        <p><a href="/" style="background: #0073aa; color: white; padding: 10px 20px; text-decoration: none; border-radius: 4px;">🏠 Go to WordPress</a></p>
+        <p><a href="/wp-admin/" style="background: #46b450; color: white; padding: 10px 20px; text-decoration: none; border-radius: 4px;">⚙️ Admin Panel</a></p>
+    </div>
+</body>
+</html>
+EOF
+
+# Create demo content script
+cat > /var/www/html/wp-content/demo-setup.php << 'EOF'
+<?php
+/**
+ * Demo content setup for WordPress on HF Spaces
+ */
+if (!defined('ABSPATH')) {
+    define('ABSPATH', dirname(__FILE__) . '/../');
+}
+
+require_once ABSPATH . 'wp-config.php';
+require_once ABSPATH . 'wp-includes/wp-db.php';
+require_once ABSPATH . 'wp-admin/includes/upgrade.php';
+
+// Create demo user if not exists
+if (!username_exists('demo') && !email_exists('[email protected]')) {
+    $user_id = wp_create_user('demo', 'demo123', '[email protected]');
+    if (!is_wp_error($user_id)) {
+        $user = new WP_User($user_id);
+        $user->set_role('administrator');
+        echo "Demo user created: demo/demo123\n";
+    }
+}
+
+// Create demo post
+$demo_post = array(
+    'post_title'    => 'Welcome to WordPress on Hugging Face Spaces!',
+    'post_content'  => '<h2>🎉 Congratulations!</h2><p>You have successfully deployed WordPress on Hugging Face Spaces. This is a demo installation running on:</p><ul><li><strong>WordPress 6.8.1</strong></li><li><strong>PHP 8.3</strong></li><li><strong>SQLite Database</strong></li><li><strong>Apache Web Server</strong></li></ul><h3>🚀 What you can do:</h3><ul><li>Create and edit posts</li><li>Install themes and plugins</li><li>Customize your site</li><li>Explore WordPress features</li></ul><p><em>Note: This is a demo environment. Data may not persist between deployments.</em></p>',
+    'post_status'   => 'publish',
+    'post_author'   => 1,
+    'post_type'     => 'post'
+);
+
+if (!get_page_by_title('Welcome to WordPress on Hugging Face Spaces!')) {
+    wp_insert_post($demo_post);
+    echo "Demo post created\n";
+}
+
+echo "Demo setup completed\n";
+?>
+EOF
+
+# Set up WordPress if not already configured
+if [ ! -f "/var/www/html/wp-config.php" ]; then
+    echo "WordPress configuration not found, copying HF Spaces config..."
+    cp /var/www/html/wp-config-hf.php /var/www/html/wp-config.php
+fi
+
+# Start Apache in background
+echo "Starting Apache web server on port 7860..."
+apache2-foreground &
+APACHE_PID=$!
+
+# Wait for Apache to start
+sleep 5
+
+# Check if WordPress is accessible
+echo "Checking WordPress accessibility..."
+if curl -f http://localhost:7860/health.html > /dev/null 2>&1; then
+    echo "✅ WordPress is accessible at http://localhost:7860"
+else
+    echo "⚠️ WordPress may not be fully ready yet"
+fi
+
+# Keep the container running
+echo "WordPress is ready! Access it at https://your-space-name.hf.space"
+echo "Admin panel: https://your-space-name.hf.space/wp-admin/"
+echo "Demo credentials: demo/demo123"
+
+# Wait for Apache process
+wait $APACHE_PID

wp-config-hf.php

@@ -0,0 +1,100 @@
+<?php
+/**
+ * WordPress configuration for Hugging Face Spaces deployment
+ * Uses SQLite database instead of MySQL
+ */
+
+// ** SQLite Database settings ** //
+define('DB_NAME', 'wordpress');
+define('DB_USER', 'root');
+define('DB_PASSWORD', '');
+define('DB_HOST', 'localhost');
+define('DB_CHARSET', 'utf8');
+define('DB_COLLATE', '');
+
+// Force SQLite usage
+define('DB_FILE', 'wp-content/database/wordpress.db');
+define('USE_MYSQL', false);
+
+/**#@+
+ * Authentication unique keys and salts for security
+ */
+define('AUTH_KEY',         'hf-spaces-auth-key-' . md5(__FILE__));
+define('SECURE_AUTH_KEY',  'hf-spaces-secure-auth-key-' . md5(__FILE__));
+define('LOGGED_IN_KEY',    'hf-spaces-logged-in-key-' . md5(__FILE__));
+define('NONCE_KEY',        'hf-spaces-nonce-key-' . md5(__FILE__));
+define('AUTH_SALT',        'hf-spaces-auth-salt-' . md5(__FILE__));
+define('SECURE_AUTH_SALT', 'hf-spaces-secure-auth-salt-' . md5(__FILE__));
+define('LOGGED_IN_SALT',   'hf-spaces-logged-in-salt-' . md5(__FILE__));
+define('NONCE_SALT',       'hf-spaces-nonce-salt-' . md5(__FILE__));
+/**#@-*/
+
+/**
+ * WordPress database table prefix
+ */
+$table_prefix = 'wp_';
+
+/**
+ * WordPress debugging mode - enabled for demo purposes
+ */
+define('WP_DEBUG', false);
+define('WP_DEBUG_LOG', false);
+define('WP_DEBUG_DISPLAY', false);
+
+/**
+ * WordPress URLs and paths for HF Spaces
+ */
+define('WP_HOME', 'https://' . $_SERVER['HTTP_HOST']);
+define('WP_SITEURL', 'https://' . $_SERVER['HTTP_HOST']);
+
+// Handle HTTPS detection behind proxy
+if (isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https') {
+    $_SERVER['HTTPS'] = 'on';
+}
+
+// Force HTTPS for admin and login
+define('FORCE_SSL_ADMIN', true);
+
+/**
+ * Increase memory limit for better performance
+ */
+define('WP_MEMORY_LIMIT', '256M');
+
+/**
+ * Disable file editing from admin panel for security
+ */
+define('DISALLOW_FILE_EDIT', true);
+
+/**
+ * Auto-update settings
+ */
+define('WP_AUTO_UPDATE_CORE', true);
+define('AUTOMATIC_UPDATER_DISABLED', false);
+
+/**
+ * Multisite settings (disabled for simplicity)
+ */
+define('WP_ALLOW_MULTISITE', false);
+
+/**
+ * Custom settings for demo environment
+ */
+define('WP_POST_REVISIONS', 3);
+define('AUTOSAVE_INTERVAL', 300);
+define('EMPTY_TRASH_DAYS', 7);
+
+/**
+ * File permissions
+ */
+define('FS_CHMOD_DIR', (0755 & ~ umask()));
+define('FS_CHMOD_FILE', (0644 & ~ umask()));
+
+/* That's all, stop editing! Happy publishing. */
+
+/** Absolute path to the WordPress directory. */
+if (!defined('ABSPATH')) {
+    define('ABSPATH', __DIR__ . '/');
+}
+
+/** Sets up WordPress vars and included files. */
+require_once ABSPATH . 'wp-settings.php';