MediaWiki开发环境搭建
- MediaWiki 开发环境搭建
这篇文章旨在帮助初学者搭建一个完整的 MediaWiki 开发环境。无论您是想为 MediaWiki 贡献代码、开发扩展、自定义皮肤,还是仅仅想深入了解 MediaWiki 的内部运作,一个本地的开发环境都是必不可少的。本文将详细介绍在 Linux、macOS 和 Windows 操作系统上搭建开发环境的步骤,并涵盖相关的工具和配置。
准备工作
在开始之前,请确保您已经具备以下基础知识:
选择操作系统
MediaWiki 可以在多种操作系统上运行。以下是推荐的几种选择:
- **Linux:** Linux 是开发 MediaWiki 的首选操作系统,因为它提供了强大的命令行工具和灵活的配置选项。Ubuntu、Debian 和 Fedora 等发行版都是不错的选择。
- **macOS:** macOS 也非常适合 MediaWiki 开发,因为它基于 Unix 系统,拥有良好的开发工具支持。
- **Windows:** 虽然 Windows 不是首选,但通过 WAMP、XAMPP 或 Docker 也可以搭建 MediaWiki 开发环境。
安装必要的软件
根据您选择的操作系统,需要安装以下软件:
Linux
1. **Web 服务器:** 使用包管理器安装 Apache 或 Nginx。 例如,在 Ubuntu 上:
```bash sudo apt update sudo apt install apache2 php libapache2-mod-php php-mysql php-mbstring php-xml php-gd php-curl ```
2. **数据库服务器:** 安装 MySQL 或 MariaDB。例如,在 Ubuntu 上:
```bash sudo apt install mysql-server php-mysqlnd ```
3. **PHP:** 确保安装了 PHP 及其必要的扩展。 安装过程中务必检查 PHP 版本是否符合 MediaWiki 的最低要求(通常是 PHP 7.4 或更高版本)。
4. **Git:** 用于从 MediaWiki 的代码仓库下载代码。
```bash sudo apt install git ```
macOS
1. **Homebrew:** 使用 Homebrew 包管理器安装必要的软件。如果没有安装 Homebrew,请先安装它:[1](https://brew.sh/)
2. **Web 服务器:** 使用 Homebrew 安装 Apache 或 Nginx。
```bash brew install httpd # Apache brew install nginx # Nginx ```
3. **数据库服务器:** 使用 Homebrew 安装 MySQL 或 MariaDB。
```bash brew install mysql brew install mariadb ```
4. **PHP:** 使用 Homebrew 安装 PHP 及其必要的扩展。
```bash brew install php ```
5. **Git:** macOS 通常预装了 Git。如果没有,可以使用 Homebrew 安装:
```bash brew install git ```
Windows
1. **WAMP/XAMPP:** 推荐使用 WAMP (Windows Apache MySQL PHP) 或 XAMPP (Cross-Platform Apache MySQL PHP Perl) 来简化安装过程。 下载地址:[2](https://www.wampserver.com/en/) 或 [3](https://www.apachefriends.org/index.html)
2. **Git:** 下载并安装 Git for Windows:[4](https://git-scm.com/download/win)
下载 MediaWiki 源代码
使用 Git 从 MediaWiki 的官方代码仓库下载源代码。
```bash git clone https://github.com/wikimedia/mediawiki.git cd mediawiki ```
这将下载 MediaWiki 的最新版本到 `mediawiki` 目录。您也可以指定特定的分支或标签。 例如,要下载 1.39 版本:
```bash git checkout REL1_39 ```
配置 Web 服务器
配置 Web 服务器以指向 MediaWiki 的安装目录。
Apache
1. 创建一个新的虚拟主机配置文件 (例如 `mediawiki.conf`)。 2. 将 `DocumentRoot` 指向 MediaWiki 的安装目录。 3. 启用必要的 Apache 模块 (例如 `mod_rewrite`)。
```apache
<VirtualHost *:80>
ServerName mediawiki.local
DocumentRoot /path/to/mediawiki
<Directory /path/to/mediawiki>
Options FollowSymLinks
AllowOverride All
Require all granted
</Directory>
ErrorLog /var/log/apache2/mediawiki_error.log
CustomLog /var/log/apache2/mediawiki_access.log combined
</VirtualHost>
```
替换 `/path/to/mediawiki` 为 MediaWiki 的实际安装路径。
3. 启用虚拟主机并重启 Apache。
```bash sudo a2ensite mediawiki.conf sudo systemctl restart apache2 ```
Nginx
1. 创建一个新的 Nginx 配置文件 (例如 `mediawiki`). 2. 配置 `server` 块以指向 MediaWiki 的安装目录。
```nginx
server {
listen 80;
server_name mediawiki.local;
root /path/to/mediawiki;
index index.php;
location / {
try_files $uri $uri/ /index.php?$args;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php7.4-fpm.sock; # Adjust PHP version if needed
}
}
```
替换 `/path/to/mediawiki` 为 MediaWiki 的实际安装路径。
3. 启用配置文件并重启 Nginx。
```bash sudo ln -s /etc/nginx/sites-available/mediawiki /etc/nginx/sites-enabled/ sudo systemctl restart nginx ```
WAMP/XAMPP
WAMP/XAMPP 通常会自动配置 Web 服务器。 您只需要将 MediaWiki 的安装目录放在 Web 服务器的根目录下 (例如 `htdocs` 目录)。
创建数据库
1. 使用 MySQL 或 MariaDB 客户端登录数据库服务器。
2. 创建一个新的数据库用于 MediaWiki。
```sql CREATE DATABASE mediawiki_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'mediawiki_user'@'localhost' IDENTIFIED BY 'your_password'; GRANT ALL PRIVILEGES ON mediawiki_db.* TO 'mediawiki_user'@'localhost'; FLUSH PRIVILEGES; ```
替换 `mediawiki_db`、`mediawiki_user` 和 `your_password` 为您自己的值。
运行 MediaWiki 安装程序
1. 在浏览器中访问您配置的 Web 服务器地址 (例如 `http://mediawiki.local`)。
2. MediaWiki 安装程序将引导您完成安装过程。
3. 按照安装程序的指示,输入数据库信息 (数据库类型、数据库名称、用户名、密码)。
4. 设置管理员帐户。
5. 完成安装。
配置本地开发环境
安装完成后,您需要配置 MediaWiki 以用于开发。
- **$wgDebugToolbar:** 启用调试工具栏,方便调试代码。 在 `LocalSettings.php` 文件中添加:
```php $wgDebugToolbar = true; ```
- **$wgDevelopmentEnvironment:** 将开发环境设置为 true。
```php $wgDevelopmentEnvironment = true; ```
- **$wgCacheDirectory:** 设置缓存目录。
```php $wgCacheDirectory = "/path/to/mediawiki/cache"; ```
- **$wgUploadDirectory:** 设置上传目录。
```php $wgUploadDirectory = "/path/to/mediawiki/uploads"; ```
确保这些目录具有正确的权限。
- **版本控制:** 使用 Git 进行版本控制,可以方便地跟踪代码更改和协作开发。
调试技巧和工具
- **PHP 调试器:** 使用 PHP 调试器 (例如 Xdebug) 可以更深入地调试 PHP 代码。
- **浏览器开发者工具:** 使用浏览器开发者工具可以检查 HTML、CSS 和 JavaScript 代码。
- **日志文件:** 查看 Web 服务器和 MediaWiki 的日志文件可以帮助您找到错误信息。
- **MediaWiki 调试函数:** MediaWiki 提供了一些调试函数,例如 `wfDebug()` 和 `wfProfile()`, 可以帮助您调试代码。
进阶主题
- **扩展开发:** 学习如何开发 MediaWiki 扩展,以扩展其功能。
- **皮肤定制:** 学习如何定制 MediaWiki 皮肤,以改变其外观。
- **API 开发:** 学习如何使用 MediaWiki API 进行数据访问和集成。
- **性能优化:** 学习如何优化 MediaWiki 的性能。
风险提示
- **安全:** 在开发环境中,安全性可能不是首要考虑因素。 但是,在将 MediaWiki 部署到生产环境之前,务必确保其安全性。
- **版本控制:** 定期提交代码到版本控制系统,以防止代码丢失。
- **备份:** 定期备份数据库和文件,以防止数据丢失。
总结
搭建 MediaWiki 开发环境需要一些时间和精力,但它可以为您提供一个强大的平台,用于学习、开发和定制 MediaWiki。 按照本文的步骤,您可以轻松地搭建一个完整的开发环境,并开始您的 MediaWiki 开发之旅。 记住,持续学习和实践是成为 MediaWiki 开发专家的关键。
技术分析 成交量分析 风险管理 期权定价 希腊字母 波动率 内在价值 时间价值 认购期权 认沽期权 期权策略 蝶式期权策略 备兑看涨期权策略 保护性认沽期权策略 跨式期权策略 strangle期权策略 二元期权交易策略 资金管理 市场趋势 技术指标 基本面分析
| Apache/Nginx | MySQL/MariaDB | | Apache/Nginx | MySQL/MariaDB | | WAMP/XAMPP | MySQL/MariaDB | |
立即开始交易
注册 IQ Option (最低存款 $10) 开设 Pocket Option 账户 (最低存款 $5)
加入我们的社区
订阅我们的 Telegram 频道 @strategybin 获取: ✓ 每日交易信号 ✓ 独家策略分析 ✓ 市场趋势警报 ✓ 新手教育资源

