一、工具功能说明

1. 本地功能：拖拽/选择php文件、粘贴代码、本地格式化、本地下载文件，无需请求后端。

2. 后台接口功能：将选中的PHP文件提交到.NET后端上传接口，后端可存储/二次格式化处理。

3. 本地浏览器处理，本地格式化不会上传代码；仅点击【上传至后台接口】才会发起网络请求。

二、后端接口约定（.NET 4.5通用）

接口地址：/FileUpload.ashx

请求方式：POST，FormData表单上传，文件字段名 phpFile

返回JSON格式示例：

// 成功返回
{
    "code": 200,
    "msg": "上传成功",
    "data": {
        "savePath": "/upload/php/xxx.php",
        "fileName": "test.php",
        "fileSize": 1258
    }
}
// 失败返回
{
    "code": 500,
    "msg": "仅允许上传php文件"
}

三、PHP 格式化前后示例（PSR12标准）

【格式化前混乱代码】

<?php
function test($a,$b){if($a>$b){echo "大于";}else{echo "小于";}$arr=["name"=>"测试","id"=>1];return $arr;}

【格式化后标准代码】

<?php

function test($a, $b)
{
    if ($a > $b) {
        echo "大于";
    } else {
        echo "小于";
    }

    $arr = [
        "name" => "测试",
        "id" => 1
    ];

    return $arr;
}

四、其他主流代码格式化规范示例

1. JavaScript / TypeScript (ESLint Standard)

// 格式化前
function demo(a,b){if(a>b)console.log("大");let arr=[1,2,3];return arr}
// 格式化后
function demo(a, b) {
  if (a > b) {
    console.log("大");
  }
  let arr = [1, 2, 3];
  return arr;
}

2. Java (Google Java Style)

// 格式化前
public class Test{public static void main(String[] args){int a=1;if(a==1){System.out.println("hello");}}}
// 格式化后
public class Test {
    public static void main(String[] args) {
        int a = 1;
        if (a == 1) {
            System.out.println("hello");
        }
    }
}

3. Python (PEP8)

# 格式化前
def demo(a,b):
    if a>b:print("大")
    arr=[1,2,3]
    return arr
# 格式化后
def demo(a, b):
    if a > b:
        print("大")
    arr = [1, 2, 3]
    return arr

4. C# (VS默认规范)

// 格式化前
public void Test(int a,int b){if(a>b)Console.WriteLine("ok");}
// 格式化后
public void Test(int a, int b)
{
    if (a > b)
    {
        Console.WriteLine("ok");
    }
}

五、常见问题

1. 上传文件无内容：确认文件后缀为 .php，编码为 UTF-8；

2. 格式化排版错乱：代码存在语法错误，修正语法后再格式化；

3. 接口上传失败：检查后端FileUpload.ashx是否部署、web.config开启文件上传权限、跨域配置。