【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') );

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

相关推荐
虎王物联5 小时前
PHP实现MQTT消息处理:物联网设备数据接收与指令下发
android·物联网·php
程序猿_极客15 小时前
【免费】分享一套优质的基于Php+Mysql的电子购物网站的设计与实现,校园小卖部系统
数据库·mysql·php·购物商城系统
PHP实战开发录16 小时前
PHP后台大文件导出内存溢出排查记录
性能优化·系统架构·php·开发
lskblog16 小时前
Ubuntu 18.04 安装 LibreOffice(用于 Word 在线预览转换)
java·linux·python·ubuntu·word·php·laravel
-今昭-16 小时前
OpenStack Dashboard 部署与图形化创建云主机实战指南
开发语言·php
那年窗外下的雪.1 天前
AIDC 学习日志|第 15 天|EVPN 多归属故障收敛与撤销机制
网络·学习·php
点我头像干啥1 天前
004:多个PDF文件合并
开发语言·pdf·php
AC赳赳老秦1 天前
企业级合规审计体系:用 OpenClaw 落地采集全链路留痕,自动生成合规审计报告
java·python·django·beautifulsoup·php·deepseek·openclaw
郑州光合科技余经理1 天前
海外版外卖系统架构:订单怎么流转、权限怎么分
java·开发语言·前端·系统架构·uni-app·php·ai编程
PHP实战开发录1 天前
企业微信客户标签同步冲突排查记录
mysql·系统安全·php·企业微信·开发