# php-ddz-api

**Repository Path**: chenkk0613/php-ddz-api

## Basic Information

- **Project Name**: php-ddz-api
- **Description**: PHP-DDZ-API 是一个用 PHP 编写的斗地主后台 API 接口项目，提供了完整的斗地主游戏后台服务。
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 1
- **Created**: 2023-11-09
- **Last Updated**: 2024-02-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
<img src="https://www.otscp.com/upload/74d80a150cb2cdbceaf9392176c5c8b.jpg" alt="icon" width="50px"/>
<h1 align="center">PHP-DDZ-API</h1>


一键部署斗地主后台数据API，支持使用以下开发语言或游戏引擎开发前端界面

**HTML/JavaScript** / C# / C++ / Java /Node.js/ Vue

Unity/UE4/UE5/Gamemaker/Cocos

只要你的前端语言或游戏引擎支持Http协议的接口协议，就可以连接本项目的API接口完成数据交互。

[快速开始](#如何使用) / [API文档](https://apifox.com/apidoc/shared-9578c30e-bfea-4456-9837-c808db251eb2) / [项目详细文字教程](https://file.otscp.com/web/#/684688853/0)

[我的个人博客](https://www.otscp.com)

</div>

## 隐私声明

该项目的API接口，属于离线部署，用户在下载后，将自己部署MySQL数据库存储玩家的数据。一切数据流动将在本地运转，作者本人不对数据安全性负责。
## 联系我
1.可以访问[我的个人博客留言板](https://www.otscp.com/comments)联系我，一般情况下这是最快让我回复的方法，你的消息将直接发送到我的手机。

2.可以访问[Bilibili](https://space.bilibili.com/95374742)私信我，我会在一天内回复。

## 更新计划
1.我即将更新匹配模式的API接口，方便玩家匹配房间，这个功能将在1.0.1中更新。

2.我即将更新游戏中的等待时间，超时将自动出牌，这个功能将在1.0.1中更新。

3.我即将更新游戏中的提示功能，并且没有能出的牌时，返回显示灰色按钮，并且超时时间改为3秒，这个功能将在1.0.2中更新。

4.敬请期待。

## 更新日志

- **2023年11月09日** 首次发布项目1.0.0。

## 特点

1. 使用PHP开发，更易于理解和快速部署。
2. 前后端完全分离，用户可以选择自己熟练的编程语言来开发游戏界面。
3. 登录和接口交互使用了双token验证，保证了数据不会错乱。
4. 丰富完整的API接口文档，方便开发者进行二次开发。
5. 个人完全免费使用。

## 在线体验

**为了示例，我做一个在线体验的斗地主游戏，可以访问下列地址。**

 [雀魂斗地主在线网址](http://game.otscp.com)

  体验账号1：123@qq.com   密码：123

  体验账号2：456@qq.com   密码：123

  体验账号3：789@qq.com   密码：123

  由于目前并未开放注册，请暂时使用以上账号游玩，但由于斗地主是一个三人游戏，我还未开发机器人AI，所以请打开3种不同的浏览器访问。
  由于我的前端能力不是很好，所以使用了更为简单入门的html和javascript开发了这个游戏。

  我相信你们可以开发出更加完美的游戏，如果你成功开发出了一个使用本项目作为后台驱动的斗地主游戏，请记得@我，我会十分愿意去下载试玩。

## 项目使用的环境
   1. php版本: 7.3.4
   2. MySQL版本：5.7.26
   3. Apache版本：2.4.39

   **🚩注意：这不意味着你必须要跟我保持一样的环境和版本，这只是我使用的项目环境，如果你无法部署或部署失败，可以尝试使用我的环境版本。如果有无法解决的问题，也可以私信[联系我](#联系我)。**



## 如何使用

- 这里只做简单说明，如果还是不太明白，可以访问[项目详细文字教程](https://file.otscp.com/web/#/684688848/0)

  1.下载本项目

  2.部署到PHP环境中

  3.运行  http://localhost/install.php  (请将localhost更换为你的网站域名)

  4.填写数据库账号、密码、设置一个新的数据库名，点击安装。

  5.安装完毕。

## 🚩注意事项

 ❗️**本项目使用单一入口机制，所以请务必将本项目放在你的网站根目录。如果是Apache，请在根目录创建.htaccess文件，并输入以下代码：**

```
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php [QSA,L]

```

 ❗️**如果是Nginx 则需要手动设置配置文件，在Nginx配置文件中添加以下代码：**

```
  if (!-e $request_filename) {
           rewrite ^/index.php(.*)$ /index.php?s=$1 last;
           rewrite ^(.*)$ /index.php?s=$1 last;
           break;
        }
```

 ❗️***本项目仅可用于个人非商业用途，教育，非营利性科研工作中。严禁商用。***