【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 天前
Windows 桌面应用自研 PHP 队列(下):完整代码与六大工程化优化
php
BingoGo7 天前
PHP 泛型之殇 泛型 RFC 提案被拒绝
后端·php
JaguarJack7 天前
PHP 泛型之殇 泛型 RFC 提案被拒绝
后端·php
用户3074596982078 天前
PHP 扩展——从入门到理解
php
鹏仔先生9 天前
拷贝漫画APP下载页PHP程序,后台带免费AI写作
php
云水一下9 天前
从零开始学 PHP 系列(一):PHP 的前世今生与开发环境搭建
开发语言·php
xingpanvip9 天前
星盘接口开发文档:本命盘接口指南
android·开发语言·css·php·lua
酉鬼女又兒9 天前
零基础入门计算机网络运输层:端到端通信核心作用、端口号分类规则、复用分用工作机制及UDP与TCP协议全方位对比详解
网络·网络协议·tcp/ip·计算机网络·考研·udp·php
dog2509 天前
不要再继续优化 TCP
网络协议·tcp/ip·php
Channing Lewis9 天前
PHP 解析 Excel 的那些坑:一次“行号错位”引发的数据丢失
开发语言·php·excel