【php】老旧PHP项目(PHP 5.6)本地环境搭建与踩坑记录

本人Java开发,刚入职新公司,对PHP不熟。本文记录了在Windows环境下使用XAMPP搭建一个老旧PHP项目(需要PHP 5.6)的完整过程,以及遇到的各种问题和解决方案。方便自己备忘,也供遇到类似情况的同事参考。

目录

1.环境准备:XAMPP老版本安装

2.IDE安装:PhpStorm(含破解)

3.获取项目代码

4.项目部署到XAMPP

5.验证XAMPP运行正常

6.踩坑记录与解决方案

6.1 页面显示源码(短标签未开启)

6.2 文件路径错误(xml_config.php找不到)

6.3 缺少MDB2.php

6.4 缺少Lite.php

6.5 数据库驱动问题:从MDB2_mssql迁移到sqlsrv

6.6 缺少MDB2_Driver_sqlsrv

6.7 数据库连接代码适配sqlsrv

6.8 PEAR依赖路径修复(解决include路径问题)

1.项目比较老了,有很多新的php不支持的函数,所以就找了XAMPP里面比较老的版本,版本号5.6.40

下载完成后安装

2.安装ide,我这里下载的是phpStorm,好像其他人用vs比较多,也可以。主要我是因为之前安装idea的时候正好有注册码,所以就一起弄了

下载完成后安装

安装完毕后开始破解,这里我用的破解方法是https://ckey.run

这里因为我电脑上有idea,所以打开phpStorm的时候会提示可以导入idea的配置

这里确认是否注册成功,这个时间对了就算破解成功了

3.从GitHub或者网上代码管理平台把你的项目克隆下来

这里会提示让你输入克隆的账号密码,具体就看不同平台的设置,这里不过多赘述

4.将你的项目文件夹放在XAMPP/htdocs下(也可以步骤3就下载到这个路径下)

5.打开xampp_start.exe,待启动完成后我们可以在浏览器输入http://localhost/如果启动成功则会自动跳转http://localhost/dashboard并显示以下页面

我们也可以点击PHPInfo查看php相关配置

6.这时候我们可以将url改成http://localhost/xxx (xxx表示你刚刚复制进去htdocs的项目的文件名)

以我的项目举例,我的项目名称是web,则我输入的就是http://localhost/web

7.接下来就是一系列错误修改了:

a.进来看到全是源码

这个问题是php存在短标签(<?代替了<?php)而你的php版本没开启

我们用文本打开XAMPP/php/php.ini(或者打开xampp-control.exe通过点击config下面的php(php.ini)跳转)

搜索short_open_tag=Off,把Off改成On后重启XAMPP

b.显示"*** Warning *** File Missing: xml_config.php"

经过排查是因为代码中
if(!file_exists($_SERVER["DOCUMENT_ROOT"] . "/App_lib/_base/xml_config.php")) die('*** Warning *** File Missing: xml_config.php');

$_SERVER"DOCUMENT_ROOT"定位的是D:/XAMPP/htdocs(就是你安装apache后系统自动帮你生成的)而项目代码需要定位到D:/XAMPP/htdocs/web才行

解决方案:这里我用了一个比较偷懒的方法:直接修改D:\XAMPP\apache\conf\httpd.conf下面的DocumentRoot和Directory,因为我这里只有一个php项目所以就这么操作了,不过代价就是localhost进页面的话就直接到项目里了

好的不报错了,又到了下一个问题了

c.这里提示没有MDB2.php文件,我看网上是直接用pear install MDB2,但我这里失败了,所以我直接去pear的官网下载了(这里提醒下记得用edge浏览器,谷歌浏览器可能因为兼容性问题导致无法下载)
https://pear.php.net/

因为是require_once(MDB2.php)函数,所以我们只需要把刚刚下载的文件加压到conf_db_connection.php同个目录下就可以了

d.这个问题跟c一样,也是去pear官网下载Lite.php,注意一下路径问题就好

e.好的下一个问题,这里显示我没有MDB2 sql server的驱动

之前的经验是一股脑儿的捣鼓怎么用MDB2_Driver_mssql这个旧驱动实现,但其中波折太多,而且旧版本的东西也不好下载,几番周折后最后选择放弃,拥抱sqlsrv

具体踩坑可以参考一下这篇文章:

要使用sqlsrv连接数据库的话首先需要下载php_sqlsrv_56_ts.dll,php_pdo_sqlsrv_56_ts.dll

具体需要下载哪个版本的的驱动可以参考这里
https://learn.microsoft.com/zh-hk/sql/connect/php/release-notes-php-sql-driver?view=sql-server-ver17#32

但是呢后面经过一番测试发现微软官方提供的3.2版本下载下来的驱动文件是32位的,现在机器64位的不支持

然后我找到了这篇文章,文章里面提供了64位驱动的下载地址
https://blog.csdn.net/flightsmallbird/article/details/86620893

然后将下载后的64位驱动文件php_sqlsrv_56_ts.dll,php_pdo_sqlsrv_56_ts.dll放入D:\XAMPP\php\ext中

接着修改D:\XAMPP\php\php.ini,添加

extension=php_sqlsrv_56_ts.dll

extension=php_pdo_sqlsrv_56_ts.dll

再调用sqlsrv前我们还需要安装ODBC Driver,下载完成后一路安装就好

安装好后修改下代码中连接数据库的方式:

从
define("DB_TYPE", "mssql", true);

改为
define("DB_TYPE", "sqlsrv", true);

最后重启apache

f.重启后发现报错不一样了,这里提示缺少MDB2_Driver_sqlsrv

那我们还是一样,去pear上下载

按照报错路径把下载的MDB2文件夹放入对应文件夹下,重新启动apache

g.这里出现的错误就是数据库连接的问题,就看代码发现之前代码用的都是mssql连接,没有sqlsrv,那么我们加上就好了(这里其实还有个地图功能没调用的问题,因为代码都是在另一个测试环境运行的,本地测试环境无法获取另一个测试环境的地图信息,后续有空再研究,暂时屏蔽了)

h.然后可能是因为配置问题,项目上有很多include函数调用位置错误的,这里用在index.php里卖弄修改pear的依赖路径,这样代码里面就不需要再做修改了

因为我的index.php一开始就调用了另一个php,所以我直接在<? 后面添加了修复依赖路径的代码
//修复PEAR的依赖路径 set_include_path( __DIR__ . '/App_lib/_base' . PATH_SEPARATOR . ini_get('include_path') );

后面再重新刷新就可以登录到首页啦!大功告成!

相关推荐
JianZhen✓1 天前
IM 聊天列表为什么总“消息乱跳“:有序插入、时间轴派生、本地截断、已读回执
开发语言·前端·php
FungLeo1 天前
FengCMS · PHP+MySQL 升级实录· 代码审计怎么闭环:REVIEW到 CLOSURE 四件套,12 个域90 篇修复文档跟到底
开发语言·mysql·php·代码审计·fengcms
FungLeo1 天前
FengCMS · PHP+MySQL 升级实录 · 一个不懂PHP 的后端,三天 216次提交完成十三年老站安全升级(项目复盘)
mysql·安全·php·安全加固·fengcms
pps-key2 天前
网络攻防入门:从“黑客梦”到合法实操(生存篇)
开发语言·web安全·php
驭渊的小故事2 天前
订单服务如何调用商品服务?一次 RestTemplate 跨服务调用入门
java·开发语言·php
Risehuxyc2 天前
来自PHP项目devnexen的回信
开发语言·php
饿了吃洗衣凝珠2 天前
SELinux
服务器·开发语言·php
普通人62 天前
PHP多维数组排序完全指南
开发语言·php·1024程序员节
码农小河663 天前
基于PHP的电商后台蜜罐系统
开发语言·php
阿洛学长3 天前
PHP开发框架对比:Laravel、Yii、Tp、Yaf、Swoole
php·laravel·swoole