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

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

相关推荐
在角落发呆2 小时前
DTU 数据转发服务器:工业物联网的隐形桥梁
开发语言·php
古城小栈4 小时前
宝塔面板部署 ThinkPHP6 后端
php
幽络源小助理6 小时前
MacCMSPro版视频影视系统源码_全开源高可用视频平台解决方案
前端·php·php源码
TO_WebNow19 小时前
使用thinkPHP8.x 访问接口提示跨域
前端·php
JSON_L21 小时前
PHP使用Intervention Image图像处理
图像处理·php·intervention
treesforest1 天前
IP数据库下载完全指南:免费与商业IP定位库对比
网络·数据库·php
原来是猿1 天前
网络计算器:理解序列化与反序列化(下)
linux·开发语言·网络·网络协议·json·php
原来是猿1 天前
Linux守护进程(Daemon)完全指南:从原理到实战
linux·运维·服务器·网络·php
阿洛学长1 天前
更好用的Wordpress二次元主题!Mokore更新1.2啦
php