トラブルシューティング EC-CUBE スマホ画像が表示されない編

技術系情報

こんにちは八号機です。
ロケッツでエンジニアを担当しています。
あるときはHTMLコーディング、あるときはシステム開発を行なっています。
 

メンバーからの調査依頼

お仕事をしていると色々な問題が発生しますよね。
私も最近メンバーから下記の依頼を受けました。
・EC-CUBEのスマホ表示で画像が表示されない。
・PC版は表示される。
・本番はスマホでも表示されるが、テスト環境だけ表示されない
上記の状態なので調査してほしい。
 

調査開始

実際にテスト環境をChromeのデベロッパーツールのスマホ表示で確認してみました。
 

 
確かに画像が表示されていません。
EC-CUBEのスマホ表示を行った際にはresize_image.phpというPHPを利用して縮小画像を表示しています。
画像のURLだけをブラウザで表示してレスポンス内容を確認してみます。
 

 
レスポンス情報に画像の情報は含まれているのを確認しました。
 
画像情報がサーバーから返ってきているのに何故画像が表示されないのでしょう。
次に本番サーバーからダウンロードした画像とテスト環境からダウンロードした画像の差を確認するためにバイナリエディタで実際の画像情報を比較して確認してみます。
 

 
テスト環境の画像の先頭バイトに本番環境には存在しない「EF BB BF EF BF」が見つかりました!
EF BB BF EF BF」とは何者なのかGoogle先生に聞いてみました。
 

 
検索結果から「EF BB BF EF BF」の正体はUTF-8のBOMっぽい感じがします。
 
せっかくなのでWikipediaの内容も確認してみます。
 

 
これで完全に原因が判明しました!
 
それでは、どのファイルがにBOMが付いているのかサーバーにあるファイルを調べてみます。
調査に利用したコマンドは以下となります。

find . -type f -name '*.php' -exec file {} + | grep "(with BOM)"

 
実行した結果は下記でした。
 

 
mtb_constants.phpファイルはEC-CUBEの管理画面で設定された内容がPHPのdefineとして定義されるファイルです。
その為、全ての処理でこちらのファイルを読み込んでいます。
このファイルにBOMが付いていた為に、画像の出力にノイズが付加されていました。
PHPは一般的に読み込むファイル順に実行されるため、
 
1. 色々なPHPファイル読み込み
2. mtb_constants.php読み込み(この時点でBOMがノイズとして出力)
3. 画像出力のPHPファイル読み込みと画像情報の出力
4. BOMが付与された事により画像ファイルとしてのフォーマットが崩れて壊れた画像ファイルをブラウザに表示
 
となっていたのが原因の様です。
早速mtb_constants.phpからBOMを取り除いてサーバーにアップし、確認してみました。
 

 
画像が表示されました!
 

まとめ

BOMは目には見えないのでソースコードをチェックしても気づき辛い。
・Windowsのメモ帳でUTF-8の文字コード指定で保存を行うとBOMが付与されるので注意。
・何か問題が発生した場合、ソースコードの記述だけが問題の要因ではない。
(調査は順調に行われたかに記載していますが、実はソースコードの調査もしていました。)
 
 
コンサルロケッツではデザイナーの他にエンジニア(コーダー)も募集してます!
・困ったらプログラム書いて解決すれば良いじゃない!
・プログラムで効率化できたら達成感を感じる!
・JSバリバリ書いちゃうよ!
・HTMLとCSSをバリバリ書いちゃうよ!
・CSVで商品移行できちゃいます!
・実はAIに興味があります!(最近、私はグループ会社のお多福ラボで研究開発しています)
・まだまだ技術力はないけど意気込みなら誰にも負けないよ!
上記に1つでも当てはまる方はコチラから是非ご応募ください。
 

ECの運営でお悩みの方!ロケッツに「ほぼ丸投げ」してみませんか?

ECサイトのコンサル・制作・運用業務に10年以上携わっているチームが、最短の成功法則を多角的に提案・実行・検証まで一貫して行います。
今後さらに拡大し、兆規模になっていくEC市場。
現在その中心にある大手ECモールの最新ノウハウと実行方法を熟知しており、常に最善のEC運営を実現していきます!

技術系情報
シェアする
コンサルロケッツステーション
タイトルとURLをコピーしました